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的 编程 原则 ,涉及 编程 中 的 永恒 真理 ， 








指导 方针 , 编程 思想 , 程序 员 的 视角 、 习 惯 和 工具 , 以 及 编程 的 反 模式 等 内 容 。 


书 中 以 “这 个 





原则 是 什么 ”“ 为 什么 要 遵循 这 个 原则 ”“ 上 具体 应 该 怎么 做 ”为 





中 心 ， 对 各 个 原则 进行 介绍 ， 简 明 扼要 ， 通 俗 易 懂 。 这 些 原则 凝聚 了 前 人 的 
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经 过 了 历史 的 考验 ， 是 指导 程序 员 改 善 代码 、 进 一 步 提升 编程 能 力 的 
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经 验 丰 富 的 人 ， 
往往 只 知 其 然而 不 知 其 所 以 然 。 





海德 格 泵 


cssp 


不 知道 大 家 有 没有 过 这 样 的 经 历 : 掌握 编程 语言 的 语法 后 会 编写 代 
码 了 ， 可 写 出 的 代码 并 不 怎么 好 。 
比如 以 下 情况 。 


雪 
单 了 。 





代码 发 布 后 频频 发 生 故 障 

发 布 代码 后 收 到 “运行 缓慢 ” “计算 机 出 现 宕 机 的 情况 ”等 投诉 
让 他 人 读 完 自己 编写 的 代码 后 ， 收 到 “代码 太 难 懂 ”“ 代 码 太 复 
杂 ”“ 代 码 不 够 优雅 ”之 类 的 评价 

隔 一 段 时 间 后 再 看 自己 编写 的 代码 ， 会 为 其 可 读 性 之 差 而 感到 


修改 代码 后 ， 程 序 完 全 不 能 运行 了 

代码 的 修改 给 意料 之 外 的 地 方 造 成 了 影响 
想 在 代码 中 添加 功能 ， 却 不 知道 该 改动 哪里 
代码 中 没有 添加 功能 的 余地 

修改 说 明文 档 后 ， 相 应 部 分 的 代码 需要 全 部 重 写 








自己 的 编程 能 力 到 达 一 定 程 度 之 后 ， 再 继续 提升 就 没有 那么 简 





如 果 能 在 一 个 合适 的 时 间 遇 到 一 份 好 工作 、 一 位 好 老师 或 一 段 好 代 


天 
码 ， 那 么 我 们 就 能 取得 进步 。 不 过 这 得 靠 运气 。 好 运 磺 中 我 们 的 概率 并 


不 大 。 











于 是 ,很 多 人 选择 看 书 来 提高 自己 的 能 力 。 不 过 ， 面 向 初学 者 的 图 
书 只 能 帮助 我 们 掌握 语法 和 一 些 基 础 知识 ， 并 不 能 帮助 我 们 提高 编程 能 
力 。 而 一 些 编程 大 师 的 著作 对 读者 又 有 很 高 的 要 求 。 阅 读 这 类 图 书 容易 
让 我 们 受挫 ， 书 中 介绍 的 知识 也 不 容易 被 我 们 理解 。 


况 





























且 ， 我 们 手头 还 有 必须 完成 的 工作 ， 这 些 工作 要 求 我 们 必须 掌握 





相关 技术 。 于 是 ， 我 们 只 能 在 工作 的 过 程 中 一 点 一 点 提高 自己 的 能 力 。 
想 成 为 一 名 更 好 的 程序 员 ， 但 苦于 不 知道 该 怎么 做 。 前 面 的 内 容 描 
述 的 就 是 这 样 一 种 状态 。 人 处 于 这 种 状态 的 人 必 不 在 少数 。 
笔者 就 是 其 中 之 一 。 于 是 ,为 了 解决 上 述 烦 恼 ， 笔者 编写 了 本 书 。 
本 书 介绍 了 软件 领域 非常 有 名 的 一 些 编程 原则 ， 这 些 原则 能 够 帮助 
我 们 编写 出 优质 的 代码 。 笔 者 以 “这 个 原则 是 什么 ”“ 为 什么 要 遵循 这 
个 原则 ”“ 具 体 应 该 怎么 做 ”为 中 心 ， 对 各 个 原则 进行 介绍 。 
作为 编程 指导 方针 的 前 提 、 准 则 、 思 想 、 习 惯 、 视 角 、 手 法 和 法 则 
等 都 属于 编程 的 原则 。 这 些 原 则 经 过 了 历史 的 考验 ， 是 帮助 我 们 更 好 地 
进行 编程 的 精髓 知识 。 
之 所 以 要 学 习 编 程 的 原则 ， 是 因为 这 些 原则 是 帮助 程序 员 成 长 的 
“捷径 ”。 
程 的 原则 不 是 某 种 特定 的 技术 ， 而 是 抽象 度 非常 高 的 信息 。 因 
此 ， 很 多 原则 看 上 去 让 人 有 些 摸 不 着 头脑 。 不 过 ， 我 们 现在 使 用 的 各 种 
技术 ,包括 结构 化 编程 、 面 向 对 象 编程 和 函数 式 编程 等 ， 都 是 为 了 更 好 
地 实现 编程 原则 的 目的 而 诞生 的 。 为 了 提高 效率 ， 这 些 编程 技术 还 会 不 
断 进化 。 
程 原则 的 目的 是 解决 编程 中 存在 的 本 质问 题 ， 具 体 来 说 包括 提高 
代码 的 可 读 性 ( 降低 代码 的 复杂 度 等 )、 降 低 编 写 代码 的 难度 (减少 代 
码 量 等 )、 避 免 出 现 bug( 消除 编程 的 副作用 等 )、 降 低 修改 代码 的 难度 
( 将 修改 带 来 的 影响 控制 在 一 定 范围 )， 等 等 。 为 了 实现 编程 原则 的 这 些 
目的 , 诞生 了 很 多 技术 ， 有 的 技术 在 诞生 之 后 逐渐 走向 了 消亡 ， 只 有 那 
些 可 以 真正 解决 本 质问 题 的 技术 留存 到 了 今天 。 
因此 ， 只 有 理解 了 编程 的 原则 ， 在 学 习 具 体 技 术 时 才能 理解 该 技术 
存在 的 理由 。 这 样 一 来 ， 我 们 就 能 构建 起 知识 网 络 ， 从 而 加 快 掌握 技术 
的 速度 ， 加 深 对 技术 的 理解 。 
另外 ， 理 解 编程 的 原则 后 ， 我 们 在 使 用 技术 时 也 会 变 得 更 加 熟练 。 
编程 的 原则 虽然 不 是 一 门 具体 的 技术 ,但 它 能 帮助 我 们 学 习 和 使 用 具体 
的 技术 。 
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编程 的 原则 是 一 般 化 的 信息 ， 























因此 不 会 过 时 。 无 论 使 用 什么 样 的 技 
术 ， 编 程 的 原则 都 能 指导 我 们 编写 代码 ， 告 诉 我 们 应 该 采取 什么 样 的 行 
动 。 编 程 的 原则 是 一 经 掌握 就 能 





直 为 我 们 提供 帮 





也 就 是 说 ,编程 的 原则 可 以 为 程序 员 的 成 长 打 好 基 





照 正确 的 方式 取得 进步 ， 加 速 程序 员 的 成 长 。 
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帮助 的 知 














识 和 智慧 。 


础 ， 使 程序 员 按 


本 书 的 目的 是 通过 介绍 编程 的 原则 使 读者 写 出 优质 的 代码 ， 成 为 一 
名 优秀 的 程序 员 。 


优秀 的 程序 员 会 写 出 优质 的 代码 。 而 优质 的 代码 是 可 以 进行 改善 的 



































































































































代码 。 可 以 进行 改善 的 代码 能 造就 更 好 的 软件 ， 这 样 的 软件 可 以 持续 为 
用 户 提供 服务 。 
希望 本 书 有 助 于 读者 成 为 一 名 优秀 的 程序 员 。 
上 上 田 勋 
2016 年 1 月 
@ 本 书 内 容 由 作者 独自 研究 完成 。 
@ 如 读者 发 现 疏 漏 或 错误 ， 请 与 出 版 商 联 系 。 
@ 对 于 使 用 本 书 内 容 的 一 切 结果 ， 本 书 作 译 者 和 出 版 社 概 不 负责 。 
@ 未 经 出 版 社 书面 许可 ， 禁 止 复 制 本 书 的 全 部 或 部 分 内 容 。 
@ 本 书 中 出 现 的 公司 名 、 商 品名 等 一 般 是 各 公司 的 商标 或 注册 商标 。 
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序章 本 书 导读 


光 有 知识 是 不 够 的 ， 还 应 当 运 用 ; 
光 有 愿望 是 不 够 的 ， 还 应 当 行动 。 


一 一 歌德 


原则 的 分 类 





本 书 将 编程 的 原则 分 为 七 章 进 行 介绍 ， 各 章 的 内 容 及 目标 如 下 。 





中 前 提 ”编程 永恒 的 真理 
这 一 章 介 绍 了 编程 中 普遍 存在 的 事实 。 
因为 这 部 分 介绍 的 原则 与 编程 技巧 无 关 ， 所 以 不 常 被 人 们 提 及 。 但 这 
些 原则 是 编程 中 至 关 重要 目 永恒 不 变 的 事实 ， 是 我 们 了 解 其 他 原则 的 前 提 。 
我 们 要 了 解 编程 的 本 质 ， 并 以 这 些 原则 为 前 提 来 编写 代码 。 


外 准则 编程 的 指导 方针 

这 一 章 介绍 了 编程 的 指导 方针 。 

其 中 的 原则 均 是 编程 中 基本 的 、 适 用 于 多 种 场合 的 “既定 规则 ”。 
与 具有 绝对 性 的 “ 铁 律 ”不 同 ， 这 些 原则 相对 宽松 ， 允 许 有 例外 出 现 。 

因此 ， 我 们 要 按照 这 些 原则 的 要 求 进行 思考 ， 并 根据 具体 情况 调整 
代码 。 这 样 一 来 ， 代 码 的 质量 自然 会 得 到 提升 。 


















































(3 思想 编程 的 意识 形态 

这 一 章 介 绍 了 编程 思想 方面 的 原则 。 

其 中 介绍 的 思想 大 致 可 分 为 编程 理论 、 软 件 架 构 的 基本 技法 、 软 件 
架构 的 非 功 能 需求 、 七 个 设计 原理 、UNIX 思想 和 UNIX 哲学 这 六 类 。 
各 类 思想 都 由 多 个 原则 构成 。 

成 功 的 软件 背后 必然 有 文化 、 哲 学 和 价值 观 等 思想 作为 支撑 。 这 些 
思想 保证 了 软件 的 质量 ， 使 软件 开发 获得 成 功 。 

我 们 要 学 习 这 些 在 背后 文 撑 着 各 个 软件 的 思想 ， 并 将 这 些 思想 应 月 
到 编程 的 设计 方针 中 。 
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视角 程序 员 的 视角 
这 一 章 介绍 了 编程 中 与 视角 、 看 法 有 关 的 原则 。 
擅长 编程 的 人 会 为 将 来 做 打算 ,编写 易于 改善 的 代码 。 他 们 明白 为 
了 在 将 来 省 心 ， 需要 从 哪 种 角度 思考 ,兼顾 哪些 要 素 。 所 以 说 ,特定 的 
视角 、 看 法 能 使 代码 “长 寿 ”。 
程 时 我 们 往往 要 面临 无 数 选择 ， 这 些 视角 将 成 为 我 们 进行 判断 的 
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依据 。 


(9S) 习惯 程序 员 的 日 党 

这 一 章 介绍 了 编程 中 与 习惯 有 关 的 原则 。 

能 写 出 优质 代码 的 程序 员 必 定 养 成 了 有 利于 写 出 优质 代码 的 习惯 ， 
他 们 的 行动 方针 也 与 写 出 优质 代码 息息相关 。 我 们 要 了 解 他 们 日 常 所 
做 、 所 想 ， 并 加 以 模仿 。 











(6 手法 程序 员 的 工具 箱 
这 一 章 介 绍 了 编程 中 与 手法 、 技 术 有 关 的 原则 。 
写 代 码 是 一 种 会 给 大 脑 带 来 负担 的 脑力 劳动 。 如 果 不 讲 究 方 法 、 
策略 ， 大 脑 很 快 就 会 疲劳 。 这 样 一 来 ， 测 试用 例 就 可 能 存在 遗漏 ， 从 而 
降低 代码 的 质量 ， 软 件 也 会 偏离 用 户 的 需求 ， 成 为 废品 。 
为 防止 此 类 情况 发 生 ， 编 程 高 手 往往 会 使 用 工具 。 这 里 说 的 工具 可 
以 是 思想 框架 ， 也 可 以 是 设计 手法 或 解决 问题 的 方法 。 
我 们 要 学 会 用 这 些 工具 来 编写 优质 代码 ， 开 发 好 用 的 软件 。 


中 法 则 编程 的 反 模 式 

这 一 章 介 绍 了 与 软件 开发 中 常见 的 陷阱 有 关 的 做 法 。 

这 些 做 法 也 叫 作 “ 反 模式 ”它们 是 从 软件 开发 历史 中 归纳 出 来 的 
下 教训 ， 揭 示 了 软件 开发 失败 的 原因 。 

提前 了 解 软 件 开发 中 “做 什么 会 导致 什么 ”的 因果 关系 ， 可 以 帮助 
我 们 在 开发 和 运 维 中 少 走 弯路 。 我 们 要 对 此 有 所 了 解 。 
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介绍 方式 





笔者 会 按 以 下 版 块 对 各 原则 进行 说 明 。 


中 原则 的 名 称 
该 版 块 用 于 介绍 原则 的 名 称 ， 其 中 包括 中 文 名 和 英文 名 ， 还 有 全 
称 、 略 称 和 别名 等 。 


咏 是 什么 
该 版 块 用 于 说 明 原 则 的 含义 。 该 部 分 只 对 原则 内 容 进行 简单 说 明 ， 
复杂 的 内 容 以 及 应 用 方面 的 内 容 将 在 “扩展 ”版 块 中 介绍 。 


3) 为 什么 
该 版 块 用 于 说 明 原则 的 必要 性 。 这 是 本 书 最 重要 的 部 分 。 明 白 了 使 
用 原则 的 目的 之 后 ， 我 们 自然 就 能 想到 实现 目的 的 手段 (技术 ) 了 。 



































怎么 做 
该 版 块 用 于 介绍 原则 的 运用 方法 。 其 中 会 介绍 有 助 于 灵活 运用 原则 
的 思考 方针 ， 还 会 介绍 将 方针 与 原则 联系 起 来 的 方法 。 
扩展 
该 版 块 用 于 介绍 原则 的 延伸 内 容 。 
\@ 关联 信息 
该 版 块 用 于 介绍 与 该 原则 相关 的 、 对 编程 有 益 的 信息 。 
外出 处 























该 版 块 用 于 介绍 原则 的 主要 来 源 。 此 处 选取 的 是 最 具 参 考 价值 的 图 





书 , 不 过 


十 这 些 图 书 不 一 定 


(8) 相关 图 书 
该 版 块 用 于 介绍 包含 了 原则 的 相关 信息 或 延伸 信息 的 图 书 。 


是 该 原则 最 早出 


岗 的 地 方 。 








OCP 


英语 Open-Closed Principle 
下文 开 闭 原则 


— 代码 的 修改 不 相互 影响 


我 们 要 让 代码 同时 满足 对 扩展 并 放 、 对 修改 关闭 这 两 个 属性 

对 扩展 开放 表示 代码 的 行为 可 以 扩 有 

对 修改 美 团 表示 当 对 代码 的 行为 进行 扩展 时 ， 其 他 代码 完全 不 会 受 
到 影响 

代码 如 果 同 时 注 是 这 两 个 属性 ， 就 可 以 在 不 影响 既 有 代码 的 前 机 下 
扩展 功能 











生灵 活 应 对 代码 的 修改 





不论 什么 软件 ， 只 
软件 的 寿命 远 比 我 们 直 
变化 ， 又 能 保 排 长期 的 稳定 
代码 能 够 灵活 应 对 变化 ， 对 扩展 开放 ， 对 修改 关闭 如 果 
能 够 满足 上 述 要 求 ， 就 算 需 求 发 生变 化 ,我 们 只 要 给 代码 浴 加 新 的 行 
为 ， 就 能 毫 无 风险 地 完成 对 软件 的 修改 

如 果 设 计 得 友 过 死相 那么 一 个 小 小 的 修改 也 会 影响 到 所 有 与 其 存 
在 依 巾 关系 的 部 分 。 死 板 的 设计 是 非常 史 弱 的 


下 在 生 谷 半 基 内 ， 就 一 定 会 发 生变 化 ， 而 及 
因此 ， 我 们 设计 也 的 软件 要 上 能 适应 
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本 给 代码 设置 接口 


我 们 妆 加 接口 

在 设计 具有 某 项 功能 的 模块 时 ， 如 果 让 模块 的 使 用 者 客户 映 直 接 误 
用 模块 的 提供 者 服务 器 ， 我 们 就 可 以 说 这 个 设计 是 死板 的 ， 因 为 在 这 种 
情况 下 如 果 想 使 用 其 他 服务 器 ， 还 需 修改 客户 六 











客户 绩 | 一 > 服务 内 





因此 ， 我 们 要 在 客户 轴 与 服务 器 之 问 为 模块 的 使 用 者 设 咯 








接口” 户 端 接口 出 服务 | 队 
站 
me EN 
fa 
i 
这 样 一 来 ， 在 证 加 拥有 新 功能 的 服务 器 时 ， 沪 服 务 器 上 有 客户 
端 接口 ， 客 户 端 就 可 以 直接 调用 新 服 我 们 就 不 用 再 修改 代码 了 





也 就是 说 ， 我 们 可 以 在 不 修改 当前 代码 的 前 提 下 浴 加 新 功能 


OCP 的 适用 范围 


OcP 的 适用 范围 是 有 限 的 ， 我们 不 能 





所 有 代码 都 遵循 OCP 









之 所 ， 是 因为 在 设 有 发 生变 更 的 情况 下 ，OCP 只 会 让 代码 变 得 
复杂 . 宛 长 

要 想 避 免 没 用 OCP， 我 们 就 需要 做 到 不 过 分 预 估 变 更 内 容 。 然 而 。 
人 是 不 可 能 党 全 正确 地 对 变更 内 容 进行 预 人 的 
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对 此 ， 我 们 可 以 先 不 管 OCP， 等 内 容 
也 就 是 说 ， 先 表册 去 接 第 一 发 邓 弹 ( 变更 )。 
以 后 在 同一 个 位 钾 按 于 六 

使 用 OCP 的 关键 在 于 预 估 ， 不 过 这 里 预 估 的 不 是 变更 内 容 ， 而 是 
发 生变 化 的 部 分 。 以 图 开 处 理 软 件 为 例 ， 图 找 的 种 类 就 是 一 个 容 
易 发 生变 化 的 部 分 ， 这 一 点 我 们 不 礁 介 到。 我 们 品 然 不 知道 下 次 要 诬 加 
的 蚌 边 形 还 是 加 形 。 但 可 以 预 估 出 图 形 的 种 类 会 发 生变 化 。 找 出 可 能 
发 生变 化 的 部 分 ， 将 该 部 分 类 到 接口 后 而 ， 这 种 手法 叫 作 流动 元 素 的 胶 
开化 


OCP 的 实现 与 设计 


面向 对 象 是 实现 OCP 的 代表 技术 

不 过 ，OCP 证 本 专属 于 出 向 对 象 。 比 如 编译 器 在 连 按时 ， 如 果 陛 切 
换 要 连接 的 诛 ， 则 可 以 在 非 而 向 对 象 的 语言 中 实现 OCP，OCP 的 通用 
范围 不 受 请 计 的 限制 

另外 ， 在 “设计 全 


发 生变 更 后 青 进行 处 理 
进行 修改 ， 从 而 避免 








可 各 




















这 类 设计 乎 法 中 ， 有 有 很 多 设计 模式 可 以 川 米 





实现 OCP， 具 有 代表 性 的 有 Strategy，Observer，Template Method 和 


Decorator, 


受 保护 变化 


GRASP ( General Responsibility Assignment Software Pattem， 通 川中 
下 分 配 软件 模式 ) 是 一 种 职责 取 动 设计 方法 ， 该 方法 中 介绍 了 一 个 名 为 

保护 变化 ”( proteeted variations ) 的 设计 模式。 这 个 设 体 来 
说 就 是 识别 出 安 和 然后 用 安定 的 接口 将 交 
界 点 包 更 直 

也 就 是 说 ， 不 安 和 
则 用 “接口 ”这 一 防护 瑞 将 变更 

















分 中 的 不 安定 因素 导致 变更 多 发 受 保护 变化 
抵 狠 在外。 这样 一 来 ， 接 吕 
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就 像 防止 火灾 可 延 的 防火 墙 和 防止 水 漫 四 方 的 防水 坦 一 样 ， 保 护 软件 不 





出 处 


伯 特 ，C. 马丁 , 考 捷 软件 开发 ， 原 川 。 模 式 与 实 路 1M 弛 针 , 详 . 北 
京 ; 清 作 大 学 出 版 柱 ,2003. 





相关 图 书 
I1) Bertrand Meyer. Object-Oriented Software ConstructionIMl.Upper 
Saddle RiverPrentice Hall 1997, 

















所 里 克 , 弗 时 和， 伊 丽 东 自 ， 旧 得, 读本， 守 拉 ， 伯 特 ， 由 并 .Head 
Fist 设计 模式 MLOreiyTawan 公司 详 ， 北 京 ， 中 国电 力 出 版 社 , 2007 

图 吉 轩 ， 扫 沫 UML 和 模式 应 用 1M| 李洋， 郊 费 ， 详 。 北京: 机柜 工 业 出 版 
社 , 2006 
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2016 

加 艾 伦 ， 沙 洛 维 , 钥 则 斯 ，R. 特 多 特 , 设计 模式 解析 IMI. 
版 社 , 2010 
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编程 术语 在 本 书 中 的 用 法 




















下 面 来 介绍 一 下 各 编程 术语 在 本 书 中 的 用 法 。 如 果 对 术语 的 理解 存 
在 偏差 ， 就 无 法 正确 理解 原则 的 含义 ,希望 大 家 能 多 加 注意 。 


中 软件 

我 们 把 编程 的 产物 统称 为 “软件 "。“ 应 用 "”“ 系 统 ” 和 “工具 ”等 
词语 通常 也 指 编 程 的 产物 ， 但 在 本 书 中 我 们 一 律 称 之 为 软件 。 

虽然 在 某 些 语 境 下 使 用 “应 用 ”这 一 叫 法 更 为 准确 ,但 是 鉴于 书 中 
介绍 的 原则 既 可 运用 于 应 用 软件 (应 用 )， 又 可 运用 于 基本 软件 (操作 
系统 )， 所 以 本 书 中 将 编程 的 产物 统称 为 软件 。 


名 代码 

我 们 把 编程 中 编写 的 东西 统称 为 “代码 ”。“ 源 代码 ”“ 源 ” “程序 ” 
和 “ 源 程序 ”等 词语 虽然 也 能 表达 相同 的 意思 ， 但 在 本 书 中 我 们 一 律 称 
之 为 代码 。 

需要 特别 注意 的 是 “程序 ”一 词 。 程 序 虽然 经 常用 来 指 代 编 程 中 
编写 的 东西 ， 但 有 时 它 也 可 以 用 来 指 代 编 程 的 产物 〈 可 执行 的 软件 )， 
这 就 容易 让 人 混淆 ， 因 此 我 们 统一 使 用 “代码 ”来 表示 编程 中 编写 的 
东西 。 


(3) 编程 

我 们 把 编写 代码 这 一 行为 统称 为 “编程 ”。 

虽然 “编码 ”一 词 也 能 表达 相同 的 意思 ， 但 它 在 部 分 人 的 印象 中 仅 
表示 将 自然 语言 转化 为 编程 语言 ， 因 此 本 书 中 我 们 使 用 “编程 ”来 表示 
编写 代码 这 一 行为 。 

































































































































































另外 ,“ 实 现 ”也 有 编程 的 意思 。 但 在 本 书 中 ,“ 实 现 ”一 词 缩小 了 
指 代 范 围 ， 仅 表示 接口 或 模块 内 的 代码 。 

















4) 程序 员 

我 们 把 编程 的 人 统称 为 “程序 员 ”"。 虽 然 根据 上 下 文 也 可 以 把 编程 
的 人 称 为 “开发 者 *”“ 开 发 人 员 ”“ 工 程 师 ”“ 软 件 工程 师 ”“ 编 码 员 ” 
等 ,但 在 本 书 中 ， 我 们 一 律 称 之 为 程序 员 。 


(9) 孜 数 

我 们 把 可 供 调用 的 代码 块 统称 为 “函数 "。 虽 然 这 类 代码 块 还 能 细 
分 为 例 行 程 序 、 功 能 、 过 程 、 信 息 、 方 法 和 成 员 函 数 等 ， 但 在 本 书 中 ， 
我 们 一 律 称 之 为 函数 。 

当然 ， 这 些 词语 指 代 的 东西 并 不 完全 相同 。 比 如 功能 有 返回 值 ， 过 
程 就 没有 返回 值 。 方 法 和 成 员 函 数 则 是 面向 对 象 语言 中 使 用 的 术语 。 

不 过 考虑 到 简洁 性 ， 本 书 中 我 们 统一 将 其 称 为 函数 。 


(6 模块 

我 们 把 整合 了 函数 、 变 量 的 责任 单元 统称 为 “模块 "。 虽 然 “ 类 ” 
“集合 了 函数 、 变 量 的 ) 文件 ”*” “组件”*” “部件 ”和 “ 库 ” 等 词语 也 可 
以 表示 “关联 性 较 强 的 代码 的 整合 体 "， 但 在 本 书 中 ,我们 一 律 称 之 为 
模块 。 


器 软件 架 构 
我 们 把 软件 的 整体 结构 统称 为 “软件 架构 ”"。 软 件 架 构 主 要 指 比 模 
块 级 别 更 高 的 软件 整体 的 构造 设计 。 男 外 ， 该 术语 也 包含 了 “设计 思 
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想 ” 的 意思 。 
























































注意 事项 





本 书 对 原则 的 说 明 具 有 三 个 特征 ,希望 大 家 在 理解 这 些 特征 的 基础 
上 对 原则 加 以 运用 。 


中 重复 只 因 重 要 

在 讲解 的 过 程 中 ， 相 同 的 内 容 会 重复 出 现 。 越 是 看 起 来 理所当然 的 
内 容 就 越 会 一 遍 一 遍地 出 现 。 

这 是 因为 许多 原则 虽然 在 观点 和 出 发 点 方面 有 所 不 同 ， 但 关键 部 分 
是 相通 的 ， 所 以 最 终 会 得 出 同一 个 结论 。 

也 就 是 说 ， 越 是 重复 出 现 的 内 容 束 越 重要 。 正 因为 重要 ， 它 们 才能 
够 变换 着 形态 ， 以 不 同 的 形式 留存 在 各 个 原则 之 中 。 

这 些 “ 理 所 当然 ”的 内 容 相 信 读 者 都 知道 ， 也 都 理解 ， 但 笔者 还 是 
希望 大 家 能 耐 着 性 子 读 一 读 。 在 阅读 的 过 程 中 不 妨 检查 一 下 有 哪些 地 方 
被 自己 忽略 掉 了 。 












































自己 思考 实用 的 代码 范例 

本 书 不 提供 代码 。 虽 然 本 书 的 目标 读者 是 程序 员 ， 但 笔者 并 没有 通 
过 具体 代码 来 介绍 编程 的 原则 。 虽 然 某 些 章 节 中 有 具体 范例 ， 但 那些 范 
例 (包括 代码 ) 只 用 来 帮助 读者 加 强 理解 ， 不 能 用 在 实践 中 。 

这 么 做 是 为 了 扩大 原则 的 适用 范围 。 一 旦 提供 了 具体 的 代码 范例 ， 
读者 的 理解 就 会 禁 铀 在 这 个 范例 里 。 男 外 ， 提 供 范 例 也 会 让 人 养 成 不 主 
动 思考 的 习惯 。 为 防止 此 类 情况 发 生 ， 笔 者 会 尽量 抽象 地 介绍 本 书 内 
容 ， 然 后 把 所 有 具体 的 运用 方案 留 给 读者 去 思考 。 

请 不 要 误会 ， 这 并 不 是 在 否定 具体 编程 技术 的 重要 性 。 相 反 ， 具体 

























































































的 编程 技术 更 为 重要 。 只 不 过 先 学 习 抽 象 的 内 容 再 学 习 具 体 技术 效果 更 
好 而 已 。 
希望 读者 能 在 了 解 原则 的 基础 上 深入 学 习 具 体 的 技术 。 





G) 若 原则 之 间 的 主张 相悖 则 取 其 平衡 点 

在 本 书 介绍 的 原则 中 ， 原 则 之 间 的 主张 会 存在 相悖 的 情况 。 

对 此 ， 我 们 不 能 说 某 一 方正 确 或 者 某 一 方 错误 ， 当 然 也 不 存在 谁 比 
谁 更 重要 的 情况 。 我 们 只 能 根据 具体 情况 来 看 哪 一 个 原则 更 加 适用 。 

问题 解决 方案 的 有 效 程度 由 具体 情况 (人 、 目 的、 时 间 、 来 龙 去 
脉 、 限 制 等 ) 决定 。 此 时 应 先 着 眼 于 大 局 ， 尽 量 收集 信息 ， 想 出 更 多 的 
解决 方案 。 在 此 基础 上 恰当 运用 原则 ， 从 战略 角度 出 发 ， 选 择 当 前 应 该 
重视 的 东西 。 

在 这 种 情况 下 ， 我 们 追求 的 应 该 是 “更 优 解 "， 而 不 是 “最 优 解 ”。 
追求 “更 优 解 ” 能 帮助 我 们 迅速 地 找 出 符合 当前 情况 的 、 平 衡 性 良好 的 
解决 方案 。 












































第 1 章 前提 1 


~ 编程 永恒 的 真理 ~ 


如 果 一 个 人 不 知道 他 和 要 驶 向 哪个 码头 ， 
那么 任何 风 都 不 会 是 顺风 。 





塞 涅 卡 


编程 没有 银 弹 


英 语 No Silver Bullet in programming 





2 出 编程 没有 特效 药 


狼人 是 坊间 传说 的 一 种 恐怖 魔兽 ， 它 能 将 我 们 平日 里 司空 见 惯 的 东 
西 瞬 间 变 成 恐怖 的 模样 。 能 镇 住 狼 人 的 方法 只 有 一 个 ， 那 就 是 将 “ 银 
弹 ” 射 入 它 的 体内 。 

在 软件 开发 中 ， 编 程 工作 有 时 会 突然 陷入 混乱 。 但 可 惜 的 是 ， 没 有 
“ 银 弹 ”可 供 我 们 解决 编程 中 的 诸多 问题 。 

编程 中 没有 魔法 般 的 万 能 解决 方案 ， 没 有 包 治 百 病 的 特效 药 。 














LEA 汪 软件 在 本 质 上 具有 难度 








作为 编程 产物 的 软件 在 本 质 上 具有 难度 。 

软件 的 本 质 是 指 软 件 不 可 欠缺 的 性 质 。 一 旦 欠缺 ， 软 件 就 不 再 是 软 
件 了 。 在 软件 的 本 质 中 ， 有 四 种 性 质 体 现 了 其 难度 ， 这 四 种 性 质 分 别 是 
复杂 性 、 同 步 性 、 可 变性 和 不 可 见 性 。 















































e 复杂 性 

软件 是 庞大 且 复 杂 的 。 几 千 万 行 的 代码 并 不 少见 。 

软件 各 组 成 要 素 之 间 的 依赖 关系 也 随 着 软件 规模 的 扩大 呈 非 线性 
增加 。 软 件 比 其 他 任何 构造 物 都 复杂 。 


。 同步 性 
软件 必须 与 现实 世界 同步 。 
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软件 并 不 是 单独 存在 的 ， 


它 与 硬件 、 网 络 、 其 他 软件 、 人 类 的 行 


动 与 习惯 等 现实 世界 的 大 量 事物 相关 联 。 软 件 与 现实 世界 相连 ， 
并 在 现实 世界 中 被 使 用 。 


现实 世界 的 复 


可 变性 


软件 必须 时 刻 保持 变化 。 
即便 软件 按照 计划 顺利 交付 ， 用 户 也 会 提出 更 多 的 要 求 ， 因 为 成 
品 软 件 会 使 世界 发 生 改 变 。 软 件 对 用 户 的 认 知 造成 影响 ， 进 而 使 
用 户 产生 新 的 需求 。 


无 法 驻足 于 安宁 之 地 是 软件 的 宿命 


不 可 见 性 


杂 性 决定 了 编程 存在 难度 。 


软件 是 概念 的 集合 体 ， 而 概念 是 肉眼 看 不 见 的 东西 。 产 品 、 进 
程 、 决 策 的 过 程 等 也 都 是 不 可 见 的 。 

虽然 可 以 将 软件 抽象 为 单纯 的 画面 ， 但 其 间 信 息 会 进行 舍 象 ， 因 
此 软件 无 法 全 部 表现 出 来 。 
软件 的 不 可 见 性 提升 了 软件 的 难度 。 


本 质 ， 是 定义 上 无 法 舍 去 的 东西 。 
的 编程 必然 也 困难 重重 。 编 程 所 处 环境 较为 复杂 ， 问 题 


么 以 软件 为 成 果 






































涉及 面 也 很 ) 





既然 软件 在 本 质 上 具有 难度 ， 那 








， 因 此 不 存在 可 以 解决 所 有 问题 的 特效 药 。 


研习 历史 ， 勇 斗 “ 复 杂 " 


我 们 要 学 习 软 件 开 发 的 历史 ， 脚 踏实 地 地 对 软件 进行 改善 。 


很 多 人 相信 软件 的 世界 中 存在 适 月 
编程 领域 并 不 存在 如 “ 银 弹 ” 
效 药 ”的 流言 所 迷惑 ， 











地 ， 通 过 科学 的 途径 对 软件 进行 改善 。 
软件 在 本 质 上 具有 难度 ， 其 最 大 的 原因 就 是 软件 具有 复杂 性 。 软 件 


























日 于 一 切 情 况 的 工具 或 技术 。 然 而 





一 般 的 万 能 技术 或 有 效 方法 。 不 要 被 “ 特 
期 待 这 种 子虚乌有 的 解决 方案 。 我 们 要 脚 踏 实 
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开发 的 历史 可 以 说 是 与 复杂 性 相 抗争 的 历史 ， 其 间 诞 生 了 许多 对 抗 复杂 
性 的 策略 。 

我 们 要 研习 历史 ， 学 习 各 种 方法 和 思路 ， 努 力 削减 复杂 性 给 软件 带 
来 的 影响 。 





| 软件 非 本 质 部 分 的 改善 





事物 丝 由 本 质 部 分 和 非 本 质 部 分 构成 。 本 质 是 指 事物 不 可 欠缺 的 性 
质 ， 欠缺 了 本 质 ， 事物 就 不 再 是 那个 事物 了 。 而 非 本 质 是 指 次 要 的 、 附 
属 的 性 质 ， 即 使 欠缺 了 这 些 性 质 ， 事物 也 还 是 那个 事物 。 

软件 开发 现场 需要 用 到 的 技术 大 多 属于 非 本 质 的 东西 。 构 建 ( build ) 
环境 、 编 程 语言 、 库 和 框架 等 都 是 软件 的 非 本 质 部 分 。 

软件 非 本 质 部 分 的 活动 对 于 推进 软件 本 质 部 分 的 活动 有 着 巨大 的 贡 
献 ， 因 为 相对 于 本 质 部 分 ， 非 本 质 部 分 更 容易 改善 。 比 如 ， 选 择 恰当 的 
编程 语言 能 够 大 幅 提 升 生产 效 率 。 

在 软件 非 本 质 部 分 的 改善 中 ， 成 效 最 大 的 当 属 自动 化 。 测 试 、 构 
建 、 环 境 搭建 等 的 自动 化 大 幅 改 善 了 工作 效率 和 工作 质量 。 我 们 要 对 软 
件 的 非 本 质 部 分 进行 自动 化 处 理 ， 尽 量 多 留 些 时 间 给 软件 的 本 质 部 分 。 
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代码 即 设计 文档 


英 语 Code as design 





CA 代码 才 是 设计 书 


在 工程 过 程 方面 ， 软 件 和 硬件 经 常 被 拿 来 比较 。 
硬件 需要 先 设 计 ， 输 出 设计 图 ， 然 后 将 设计 图 用 作 输 入 ， 进 行 物理 
上 的 “制造 ”。 
将 这 一 过 程 类 比 到 软件 中 ， 就 相当 于 上 游 工 程 负责 人 先 通过 设计 
创建 出 基本 设计 文档 ， 然 后 将 设计 文档 用 作 输 入 ， 由 程序 员 编 写 代码 完 
然而 这 一 类 比 存在 错误 。 不 管 是 上 游 的 基本 设计 ， 还 是 详细 设计 、 
启程 、 测 试 和 调试 ， 这 些 都 属于 设计 环节 ， 输 出 的 设计 文档 就 是 代码 ， 
而 构建 发 布 版 本 属于 制造 环节 。 也 就 是 说 ， 负 责 制造 的 不 是 程序 员 ， 而 
是 编译 器 或 构建 系统 。 
从 这 个 角度 来 说 ,编程 属于 设计 行为 。 在 软件 开发 过 程 中 生成 的 所 
有 文本 ， 其 中 能 真正 称 得 上 工程 文档 的 ， 只 有 代码 。 
所 以 说 ， 作 为 设计 行为 产物 的 代码 才 是 设计 文档 。 



































车 







































































2 出 改善 对 象 是 代码 








产品 的 改善 在 设计 环节 进行 。 产 品 的 性 能 无 法 在 制造 环节 得 到 提 
升 。 制 造 环节 和 生产 环节 是 按照 设计 制作 产品 的 过 程 。 
程 阶段 会 有 许多 内 部 代码 和 外 部 功能 方面 的 改善 ， 因 此 编程 属于 
设计 行为 。 











EE 
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另外 ， 基 本 设计 、 详 细 设计 、 编 程 、 测 试 和 调试 是 一 个 不 可 分 割 的 
整体 ， 各 项 任务 相互 依存 。 拿 基础 设计 来 说 ， 很 多 东西 只 有 在 开始 编程 
之 后 才能 搞 清楚 。 位 于 上 层 的 设计 文档 必须 等 到 编程 结束 之 后 才能 确定 
下 来 ， 这 就 证 明了 这 几 项 任务 是 一 体 的 。 

设计 输出 的 只 有 代码 。CASE 工具 和 UML ( Unified Modeling Language， 
统一 建 模 语言 ) 虽然 能 够 起 到 辅助 作用 ,但 设计 最 终 必 须 使 用 编程 语言 
来 表现 ， 然 后 经 构建 和 测试 来 验证 、 优 化 。 上 游 设 计 和 下 游 设计 只 能 使 
用 编程 语言 作为 共同 的 表现 方式 。 



























































过 全 优秀 的 程序 员 必 不 可 少 


下 面 来 看 一 下 为 什么 说 编程 是 一 种 设计 行为 。 弄 清楚 这 一 点 后 ， 我 
们 就 能 看 清 编程 的 本 质 ， 确 定 开发 的 体制 与 环境 了 。 

首先 要 明白 ， 编 程 是 一 种 具有 创造 性 的 行为 。 在 有 些 人 的 眼中 ， 编 
程 只 是 把 需求 符号 化 了 而 已 。 然 而 ， 编 程 不 是 机 械 性 的 劳动 ， 设 计 需 要 
创造 力 和 技艺 。 新 人 初来乍到 ， 不 可 能 一 下 子 就 上 手 ， 这 种 工作 应 由 经 
验 丰富 的 优秀 程序 员 来 完成 。 

另外 ， 基 本 设计 、 详 细 设 计 、 编 程 、 测 试 和 调试 是 设计 中 不 可 分 割 
的 任务 。 将 这 些 任 务 分 割 开 并 不 是 明智 之 举 。 也 就 是 说 ， 全 体 程序 员 要 
共同 参与 设计 ,一 起 来 编写 代码 。 当 然 ， 我们 也 可 以 想 办 法 将 设计 图 自 
动 变 为 软件 ， 但 这 一 方案 并 不 现实 。 与 其 将 来 找 人 把 不 依赖 于 编程 语言 
的 设计 图 翻译 成 代码 ， 倒 不 如 让 设计 者 自己 编写 代码 来 得 省 心 。 

更 重要 的 是 ， 既 然 代 码 属于 设计 的 范畴 ， 我 们 就 应 该 尽早 开始 编写 
代码 。 不 写 代 码 的 话 就 无 法 弄 清 很 多 事情 ， 设 计 也 只 会 无 限 拖延 下 去 。 



















































































;有 二 明 罗 塞 塔 石碑 











代码 是 设计 文档 ， 但 代码 不 是 唯一 的 文档 。 除 了 代码 ， 还 有 许多 文 
档 是 必 不 可 少 的 。 
很 多 人 认为 敏捷 开发 是 一 种 轻视 文档 的 开发 过 程 。 但 实际 上 ， 敏 捷 
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开发 只 是 不 生成 无 用 的 文档 ， 并 没有 主张 “不 生成 文档 ”。 











在 具有 持续 性 的 编程 活动 中 ， 最 受 重视 的 是 一 个 叫 作 “ 罗 塞 塔 石 








碑 ” 的 文档 。 这 是 一 份 写 





给 未 来 维护 负责 人 的 简单 手册 ， 其 中 描述 了 用 


于 理解 软件 开发 环境 和 软件 构架 的 信息 。 








在 软件 开发 环境 方面 





， 文 档 描述 了 构建 与 测试 过 程 的 执行 方法 。 构 














建 中 包含 的 测试 能 防止 维护 负责 人 在 理解 软件 时 落 入 陷阱 。 
在 软件 架构 方面 ， 文 档 中 包含 了 一 些 能 纵 观 全 部 代码 的 图 表 。 





代码 能 很 好 地 表达 


“怎么 做 ”和 “是 什么 ”"， 却 不 能 表达 “为 什 





么 ”， 也 就 是 设计 理由 。 将 设计 理由 描述 在 文档 中 ， 能 为 维护 负责 人 提 

















供 判断 材料 。 这 种 做 法 能 在 很 多 情况 下 起 到 作用 。 
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代码 必然 被 修改 


莫 语 Code will be changed 





才情 代码 总 是 要 修改 的 





代码 不 是 写 完 就 结束 了 ， 它 在 日 后 必然 会 被 修改 。 没 有 写 完 就 扔 的 
一 次 性 代码 。 

在 编写 代码 的 时 候 ， 我 们 应 将 “代码 会 被 修改 ”这 一 点 作为 进行 判 
断 和 选择 时 的 优先 考虑 事项 。 


IE 代码 是 无 常 的 


软件 在 本 质 上 具有 复杂 性 ， 这 就 决定 了 它 不 可 能 是 完美 无 缺 的 。 软 
件 在 发 布 后 必然 会 发 生 故 障 ， 这 时 我 们 就 需要 对 故障 进行 修复 。 

另外 ， 用 户 可 能 在 软件 发 布 后 产生 新 的 需求 ， 因 为 有 些 问 题 只 有 等 
到 用 户 实际 使 用 软件 之 后 才能 被 发 现 。 任 何 软件 都 不 可 能 在 首次 发 布 时 
就 满足 用 户 所 有 的 需求 。 

除 用 户 自身 之 外 ， 用 户 所 在 商务 环境 的 变化 也 会 导致 需求 发 生变 
化 。 软 件 必须 迎合 这 种 变化 。 如 果 执 着 于 最 初 编写 的 程序 ， 做 出 没有 人 
用 的 软件 ， 那 么 一 切 都 是 徒劳 。 

换个 角度 来 看 ， 开 发 新 软件 的 编程 过 程 其 实 也 可 以 看 作 一 种 “ 修 
改 ”。 在 编程 时 ， 我 们 会 给 昨天 编写 的 代码 添加 新 代码 ， 会 为 了 让 代码 
更 易 读 而 重 构 。 从 团队 的 层面 来 讲 也 是 一 样 的， 比如 第 一 次 迭代 中 的 代 
码 会 在 第 二 次 迭代 中 被 修改 。 不 管 在 哪个 阶段 ， 代 码 都 会 因 各 种 各 样 的 
理由 而 被 修改 。 
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怎么 做 


EE 














编写 经 得 起 修改 的 代码 


写 的 代码 要 经 得 起 修改 。 














因此 ， 提 高 代码 的 可 读 性 就 显得 
比 写 要 费时 间 。 如 果 以 代码 会 被 修改 为 前 提 ， 那 么 不 管 写 代码 需要 耗费 








尤为 重要 了 。 代 码 这 种 东西 ， 





程 中 的 任何 一 个 判断 都 要 以 代码 会 被 修改 为 前 提 。 也 就 是 说 ， 编 











读 远 





多 少时 间 ， 只 要 读 代码 的 时 间 能 够 缩短 ， 我 们 就 能 把 消耗 在 写 代 码 上 的 

















时 间 赚 回来 。 
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第 2 章 准则 


~ 编程 的 指导 方针 ~ 


在 我 们 尚未 给 予 自己 支配 本 身 的 力量 时 ， 
解放 我 们 精神 的 所 有 行为 ， 都 是 百 害 而 无 一 益 的 。 


一 一 歌德 


英 语 Keep It Simple, Stupid 
或 Keep It Short and Simple 
中 文 保持 代码 简洁 





2 午 保 持 代 码 简 洁 


编写 代码 时 ， 要 优先 保证 代码 的 简洁 性 。 
不 管 是 从 零 开始 编写 代码 ， 还 是 修复 故障 或 扩展 功能 ， 都 要 注意 保 
持 代码 简洁 。 











ULA 代码 会 越 来 越 没 有 秩序 





随意 修改 代码 会 使 代码 变 得 越 来 越 复杂 ， 越 来 越 没 有 秩序 。 

复杂 的 代码 可 读 性 较 差 且 难 以 修改 。 强 行 修改 不 仅 会 降低 代码 的 质 
量 ， 还 会 浪费 时 间 。 这 样 一 来 ， 我 们 就 无 法 保证 能 在 合适 的 时 间 发 布 修 
正版 或 者 对 软件 进行 更 新 。 如 果 我 们 没有 重视 这 个 问题 ， 依 旧 强行 修改 
代码 ， 代 码 就 会 变 得 没有 人 能 看 懂 ， 最 终 腐化 为 无 用 之 物 。 

而 一 份 简洁 的 代码 ， 其 各 个 组 成 要 素 也 是 简洁 的 ， 各 要 素 承 担 的 职 
责 也 都 降 到 了 最 小 ， 各 要 素 之 间 的 关系 也 比较 简单 。 因 此 ， 简 洁 的 代码 
可 读 性 高 ， 容 易 理解 ， 便 于 修改 。 各 要 素 职 责 明 确 ， 使 得 测试 也 变 得 简 
单 易 行 。 程 序 员 之 间 能 更 加 轻松 地 通过 代码 进行 交流 ， 减 少 了 在 现实 世 
界 中 多 余 的 对 话 ， 节 约 了 交流 成 本 。 这 样 ， 我 们 就 能 保证 在 不 降低 开发 
速度 的 情况 下 对 软件 进行 长 期 维护 。 

代码 必然 会 被 修改 ， 因 此 易于 修改 的 特性 对 代码 来 说 不 可 或 缺 。 保 
持 代码 简洁 可 以 使 代码 拥有 易于 修改 的 特性 。 
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lA 时 不 要 画蛇添足 


我 们 要 将 简洁 视 为 编程 的 指南 针 。 尽 可 能 将 多 余 的 、 过 剩 的 要 素 从 
代码 中 剔除 。 

为 此 ， 在 编程 的 过 程 中 我 们 要 经 常 问 自己 程序 运行 必 不 可 少 的 要 素 
有 哪些 。 

听 起 来 唯心 ， 但 这 一 点 其 实 很 重要 ， 因 为 一 旦 放松 和 警惕， 代码 就 会 
变 得 复杂 。 比 如 下 面 这 几 种 情况 。 























e 试图 使 用 新 学 会 的 技术 
学 会 一 门 新 技术 后 ， 人 们 倾向 于 使 用 新 技术 写 出 一 些 无 谓 的 代码 。 
但 是 ， 代 码 并 不 是 用 来 炫 姿 聪明 才智 的 ， 它 的 作用 是 给 用 户 提 供 
价值 。 我 们 不 能 在 代码 上 要 聪明 。 
我 们 要 多 多 革 酌 代码 的 写法 ， 努 力 保持 代码 简洁 。 


e 以 备 将 来 之 需 
有 时 人 们 觉得 将 来 会 用 到 某 些 功能 ， 认 为 最 好 趁 现在 写 下 来 ， 于 
是 编写 了 过 剩 的 代码 。 
现在 用 不 到 的 东西 就 不 应 该 现在 写 ， 因 为 在 大 多 数 情况 下 ， 这 些 
东西 将 来 也 用 不 到 。 
我 们 应 该 只 写 当 前 需要 的 代码 ， 保 持 代码 简洁 。 


e 擅自 增加 需求 
程序 员 有 时 会 擅自 增加 需求 ， 添 加 多 余 的 代码 。 他 们 觉得 ， 某 个 需 
求 必 要 与 否 、 正 确 与 否 ， 与 其 找 用 户 确 认 ， 不 如 自己 直接 写 出 来 。 
但 是 ， 需 求 是 由 用 户 决定 的 ， 程 序 员 不 可 以 擅自 增加 。 
一 旦 添加 了 不 必要 的 代码 ， 花 费 在 维护 上 的 时 间 就 会 像 滚雪球 一 
样 增 加 。 不 写 多 余 的 代码 是 保证 代码 简洁 的 秘诀 。 
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KISS 原则 的 适用 范围 


在 软件 开发 中 ，KISS 原则 不 仅 适 用 于 代码 ， 还 适用 于 功能 设计 。 

功能 繁多 的 复杂 软件 不 会 得 到 用 户 的 青睐 ， 功 能 简洁 、 接 口 简洁 的 
软件 才 会 受 欢迎 。 

另外 ，KISS 原则 原本 就 适用 于 一 切 工程 。 只 不 过 产物 的 复杂 化 倾 
向 在 软件 开发 中 表现 得 尤为 突出 。 造 成 这 种 情况 的 原因 之 一 是 人 们 认为 
软件 开发 能 相对 灵活 地 应 对 需求 。 


E3:3El eM less is more 


less is more 的 意思 是 “ 少 就 是 多 ”。 这 句 话 出 自 建筑 领域 ， 指 通过 
减少 装饰 等 表层 要 素 和 空间 结构 等 内 部 要 素 ， 使 建筑 物 能 够 经 受 住 各 种 
外 在 因素 的 影响 ， 产 生 更 加 丰富 的 空间 。 

这 个 观点 同样 适用 于 软件 。 不 写 多 余 的 代码 ， 使 代码 保持 简洁 ， 防 
患 于 未 然 。 男 外 ， 通 过 这 种 方式 写 出 来 的 代码 干净 整洁 ， 颇 具 美 感 。 

我 们 要 时 常 审视 自己 写 的 代码 ， 问 问 自己 这 些 代码 是 否 多 余 。 


E33 和 到 奥 卡 姆 剃刀 


奥 卡 姆 剃刀 原理 主张 不 应 假设 非 必要 的 前 提 来 说 明 某 个 事物 。 换 名 
话说 ， 就 是 当 一 个 事物 存在 多 种 解释 时 ， 最 简单 的 那个 解释 是 正确 的 。 
该 原理 能 帮助 我 们 在 理解 事物 时 减轻 思考 方面 的 负担 。 

这 个 原理 对 于 编程 同样 有 效 。 在 可 以 实现 相同 功能 的 情况 下 ， 不 含 
多 余 内 容 的 代码 更 能 减轻 阅读 者 的 负担 ， 可 读 性 更 高 ， 也 更 易于 改善 。 
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DRY 


英 语 Don’t Repeat Yourself 
中 文 不 要 重复 





严禁 复制 粘贴 代码 


不 可 以 重复 写 相 同 的 代码 。 
将 整个 逻辑 随便 复制 粘贴 到 其 他 地 方 去 用 是 造成 代码 重复 的 主要 原 
因 。 这 样 一 来 ， 同 一 个 逻辑 将 出 现在 多 个 地 方 。 














func A() { func B() { 
Prog 1 Proc 4 


PEOC 3 Proc 5 








条 件 相同 的 控制 语句 的 代码 块 有 时 会 重复 出 现在 代码 各 处 ， 这 也 是 
复制 粘贴 所 致 。 当 条 件 分 支 相 同 但 分 支 后 的 处 理 不 同时 ， 如 果 先 复制 粘 
贴 代码 块 再 单独 修改 处 理 部 分 ， 就 会 出 现 这 样 的 结果 。 

















func C() { 
SEE 人 ER 


XXX OOO 
} else if(c) { } else if(c) { 
XXX OOO 
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处 使 用 ， 














另外 ， 用 于 对 代码 进行 说明 的 注释 虽然 不 属于 纯粹 意义 上 的 代码 重 
复 , 但 它 也 是 重复 的 一 种 。 将 代码 翻译 成 母语 的 注释 就 属于 这 一 类 。 
1 写 代码 时 要 注意 避免 上 述 情 况 出 现 。 一 旦 发 现 重 复 的 代码 ， 要 立 
刻 予 以 消除 。 








MW 




















2 出 代码 无 法 得 到 改善 





代码 一 旦 出 现 重 复 ， 故 障 修复 、 添 加 功能 等 ， 代 码 的 改善 措施 就 会 
变 得 难以 实施 。 具 体 来 说 ， 我 们 会 遇 到 以 下 困难 。 


e 代码 的 可 读 性 下 降 
相同 的 代码 出 现 多 次 ， 从 量 的 角度 来 看 是 “代码 量变 大 "， 从 质 
的 角度 来 看 是 “复杂 度 变 高 "。 显 然 ， 代 码 的 可 读 性 会 下 降 。 
无 法 准确 理解 代码 就 无 法 确立 修改 方针 。 


e 代码 难以 修改 
当 相 同 的 代码 出 现在 多 处 时 ， 只 有 正确 修改 每 一 处 代码 ， 才 能 确 
保 整 体 的 一 致 性 。 稍 有 不 愤 ， 修 改 就 会 出 现 遗 漏 。 
另外 ， 即 使 代码 完全 相同 ， 有 时 某 些 地 方 也 用 不 着 修改 。 在 这 种 
情况 下 ， 我 们 就 需要 阅读 前 后 代码 ， 判 断 这 一 处 是 否 需 要 修改 。 
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若 当 前 重复 的 代码 之 间 存 在 细微 差别 ， 我 们 就 需要 更 加 深入 地 阅 
读 各 个 位 置 的 代码 。 控 制 语句 的 条 件 内 容 或 条 件数 量 只 要 存在 一 
点 点 差别 ， 理 解 的 难度 就 会 进一步 增 大 。 和 弄 不 好 代码 会 因 无 法 解 


读 而 得 不 到 改善 。 


e 没有 测试 


出 现 重 复 的 代码 大 多 是 遗留 代码 ， 也 就 是 说 ， 这 部 分 代码 没有 经 


过 任何 测试 。 


在 没有 测试 的 状态 下 ， 就 算 我 们 拼 尽 全 力 去 修改 遗 


新 故障 的 概率 还 是 很 大 。 











留 代 码 ， 发 生 


就 算 克 服 了 上 述 所 有 困难 ， 费 尽 九 牛 二 虎 之 力 完成 修改 ， 这 些 代码 








会 因为 动 了 多 个 “ 大 手术 ”而 变 得 更 加 混乱 。 长 此 以 和 
ee 


二 将 代码 抽象 化 


我 们 可 以 通过 对 代码 执行 抽象 化 操作 来 消除 重复 。 


E， 当 } 混乱 葛 延 





对 代码 的 逻辑 执行 抽象 化 操作 ， 其 实 就 是 给 整个 处 理 合 名， 将 其 


数 化 、 模 块 化 。 至 于 数据 ， 则 需要 起 个 名 字 定 义 为 常量 。 
部 分 全 部 置换 为 抽象 后 的 内 容 。 
抽象 化 有 以 下 几 个 优点 。 





@ 减少 了 代码 量 ， 减 轻 了 阅读 负担 


a 


@ 因为 逻辑 和 数据 有 了 名 称 ， 所 以 代码 的 可 读 性 变 高 了 

@ 重复 的 代码 集中 到 了 一 处 ,我 们 只 对 这 一 处 进行 修改 即 可 。 于 
是 ， 代 码 的 修改 操作 变 得 简单 ， 代 码 的 质量 也 得 到 了 保证 

@ 抽象 化 的 部 分 易于 重复 使 用 。 在 添加 新 功能 的 时 候 ， 重 复 使 用 代 


码 可 以 更 快 、 更 好 地 完成 编程 


不 过 ， 执 行 抽象 化 操作 需要 我 们 跨越 心理 方面 的 障碍 。 比 如 将 逻辑 
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转化 为 函数 的 操作 就 相当 费时 间 ， 我 们 需要 有 足 够 的 耐心 。 男 外 ， 由 于 
我 们 修改 的 是 原本 可 以 运行 的 代码 ， 所 以 修改 后 的 代码 存在 不 能 正常 运 
行 的 风险 。 抽 象 化 操作 还 有 一 个 最 明显 的 缺点 ， 那 就 是 太 麻烦 。 

然而 ， 避 免 重复 这 一 点 没有 商量 的 余地 。 从 长 远 看 来 ， 避 免 重复 的 
利 大 于 弊 ， 这 是 历史 总 结 出 来 的 结论 。 所 以 ， 即 便 要 花 时 间 重 构 ， 即 便 
要 花 时 间 消 除 代码 不 能 正常 运行 的 风险 ， 即 便 操 作 起 来 有 些 麻 烦 ， 我 们 
也 要 消除 重复 的 代码 。 


DRY 的 适用 范围 


DRY 不 仅 适 用 于 代码 ， 还 适用 于 有 关 软 件 开发 的 一 切 活动 。 

比如 软件 开发 作业 中 存在 大 量 的 重复 劳动 。DRY 也 适用 于 这 些 重复 
作业 。 

具体 来 说 就 是 将 重复 作业 自动 化 。 这 样 就 可 以 消除 手动 作业 的 负 
担 ， 同 时 保证 操作 的 正确 性 ， 排 除 人 为 的 离散 因素 。 

最 具 代表 性 的 自动 化 作业 是 对 软件 进行 测试 、 构 建 和 发 布 的 持续 集 
成 。 持 续集 成 就 是 由 设置 了 特定 任务 的 集成 服务 器 准确 且 频 繁 地 自动 执 
行 软件 的 构建 、 测 试 和 部 署 等 作业 。 除 了 能 消除 重复 的 手动 作业 ， 持 续 
集成 还 有 保证 构建 质量 、 使 构建 不 再 依赖 于 特定 人 物 、 帮 助 我 们 尽早 发 
现 问题 等 优点 。 


DRY 与 编程 技术 


与 其 说 编程 技术 大 多 具备 实现 DRY 的 功能 ， 不 如 说 大 部 分 编程 技 
术 以 消除 重复 作为 目标 之 一 。 比 如 结构 化 编程 和 面向 对 象 编程 中 就 包含 
了 消除 重复 的 技术 。 

同样 ， 消 除 重复 也 是 大 部 分 设计 手法 的 目标 之 一 。 设 计 模 式 就 是 具 
有 代表 性 的 一 种 设计 手法 ， 它 提供 了 代码 结构 模式 以 达到 重复 使 用 代码 
的 目的 。 从 另 一 个 方面 来 看 ， 设 计 模式 也 可 以 说 是 一 种 防止 重复 思考 
(重复 思考 同一 问题 的 解决 方案 ) 的 手法 。 
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一 般 来 讲 ， 技 术 和 方法 的 诞生 都 伴随 着 一 定 的 目的 。 我 们 在 学 习 技 
术 时 ， 不 仅 要 学 习 具 体 做 法 ， 还 要 思考 这 项 技术 的 目的 是 什么 ， 这 样 才 
能 事半功倍 。 














局 二 = 不 得 已 的 重复 








软件 开发 中 难免 会 有 不 得 已 发 生 重 复 的 情况 。 

比如 阻抗 失 配 。 在 填补 编程 与 其 所 用 服务 之 间 不 协调 的 地 方 时 ， 填 
补 信息 难免 会 发 生 重复 。 

阻抗 失 配 原本 是 电学 领域 的 术语 ， 指 素材 之 间 由 于 阻抗 不 同 引 起 
反射 ， 使 能 量 无 法 顺利 传递 。 这 里 用 来 比喻 结构 不 同 的 二 者 在 连接 时 的 
难度 。 

在 软件 的 世界 中 ， 失 配 容易 发 生 在 不 同 抽象 化 风格 的 交界 处 。 最 典 
型 的 例子 就 是 面向 对 象 编程 的 类 和 关系 数据 库 的 表 。 当 关系 数据 库 与 使 
用 关系 数据 库 的 编程 语言 同时 存在 时 ， 为 填补 二 者 的 失 配 ， 需 要 在 关系 
数据 库 端 的 表 定 义 、 代 码 端 的 表 映 射 配置 文件 和 源 文 件 三 处 存放 相同 的 
信息 。 这 种 重复 的 发 生 实 属 无 奈 。 

不 过 ， 我 们 并 非 没 有 对 策 来 解决 上 述 问 题 。 比 如 ， 我 们 可 以 将 信息 
集中 存放 在 一 处 ， 然 后 想 办 法 让 其 他 信息 自动 生成 。 这 样 就 能 对 信息 进 
行 统一 管理 了 。 


wer 


WET 是 与 DRY 相对 的 概念 ， 它 是 “Write Every Time” 和 “Write 
Everything Twice” 的 缩 略语 ， 表 示 重 复 同 样 的 事情 。 有 趣 的 是 ，DRY 
(于 ) 和 WET( 湿 ) 不 管 作 为 英文 单词 还 是 缩 略 语 ， 意 思 都 是 相反 的 。 

WET 常用 于 讽刺 那些 没有 实现 DRY 的 代码 。 
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司 : 避 司 二 到 OFOP 


OFOP (One Fact in One Place ) 的 意思 是 一 个 地 方 只 有 一 个 事实 。 
它 是 数据 库 理论 设计 中 表 设 计 的 一 项 重要 原则 。 

DRY 要 求 代码 不 能 出 现 重 复 ， 而 OFOP 要 求 数据 库 中 不 能 存储 重 
复 的 数据 。OFOP 原则 可 以 防止 数据 元 长 和 数据 不 一 致 (更 新 异常 ) 的 
情况 发 生 。 

要 想 实现 OFOP,“ 标 准 化 ”这 一 设计 手法 必 不 可 少 。 在 编程 中 ， 消 
灭 重复 的 方法 有 很 多 ， 但 对 数据 库 而 言 ,“ 标 准 化 ”是 独一无二 的 设计 
手法 。 






































本 : 忆 且 二 旺 OAOO 








OAOO ( Once and Only Once ) 的 意思 是 有 且 仅 有 一 次 。 简 单 来 说 就 
是 不 可 以 出 现 重复 ， 与 DRY 的 意思 和 目的 相同 。 

不 过 ，OAOO 的 适用 范围 要 比 DRY 小 ， 它 只 能 用 在 编程 语法 上 。 
OAOO 强调 的 是 代码 不 能 重复 以 及 不 能 有 多 余 的 代码 。 


E3353 后 I 遗留 代码 


重复 出 现 的 代码 大 多 没有 测试 程序 。 没 有 测试 程序 的 代码 称 为 遗留 
代码 。 

过 去 说 起 遗留 代码 ， 指 的 是 那些 以 前 写 的 不 容易 理解 的 、 难 以 修改 
的 代码 。 而 如 今 ， 为 了 对 测试 程序 能 带 来 质量 保证 这 一 点 加 以 重视 ， 人 
们 又 将 遗留 代码 重新 定义 为 “没有 测试 程序 的 代码 ”。 

这 样 一 来 ， 没 有 测试 程序 的 代码 就 全 部 变 成 了 垃圾 代码 。 就 算 代码 
整齐 ， 结 构 严 说， 只 要 没有 测试 程序 ， 那 它 就 是 遗留 代码 。 

这 个 定义 或 许 给 人 一 种 过 于 严格 的 感觉 。 代 码 整 齐 确实 是 好 事 , 但 
这 并 不 意味 着 整齐 就 万 事 大 吉 了 。 之 所 以 这 么 说 ， 是 因为 在 没有 测试 程 
序 的 情况 下 修改 代码 非常 危险 。 如 果 有 测试 程序 ， 我 们 就 可 以 一 边 检 验 
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代码 一 边 快 速 修 改 代码 。 改 善 代 码 时 也 一 样 。 如 果 没 有 测试 程序 ， 就 无 
法 得 知 代码 到 底 是 变 好 了 还 是 变 坏 了 。 

因此 ， 当 遇 到 遗留 代码 时 ， 我 们 首先 要 为 其 编写 测试 程序 。 就 算 代 
码 不 够 优雅 也 没有 关系 。 总 之 ,不 论 用 什么 方法 ,一 定 要 先 测试 再 修 
改 。 为 了 保证 代码 质量 ， 这 个 步骤 必 不 可 少 。 







































































出 处 

[1] 安德鲁 亭 特 , 大 卫 … 托马斯 . 程序 员 修炼 之 道 [M]. 周 爱民 , 译 . 北京 : 电 
子 工业 出 版 社 , 2011. 

相关 图 书 

1] 迈克 尔 * C. 费 瑟 . 修改 代码 的 艺术 [M]. 修 伯 莪 , 译 . 北京 : 机 械 工业 出 版 
社 , 2014. 

2] 保罗 M. 杜 瓦尔 , 等 . 持续 集成 [M]. 王 海 鹏 ， 贾 立 群 , 译 . 北京 : 机 械 工 





























业 出 版 社 , 2008. 

3] 凯 佛 林 . 亭 尼 . 程序 员 应 该 知道 的 97 件 事 [M1]. 李 军 , 译 . 北京 : 电子 工业 

出 版 社 , 2010. 

4] 晴 俊 贵 . 良 U\ 乙 一 卜 在 书 < 技术 一 许 闪 交 二 < 保守 UL 守 节 UYF 口 FS 

分 作法 [M]. 东京 : 技术 评论 社 , 2011. 

5] 大 机 繁 . /7 了 7 卜 夕 工 了 了 并 有司 慰 术 世 座 UL 办 ~ 「 人 月 DO 神话 」 在 超 元 芯 

[M]. 东京 : 技术 评论 社 , 2009. 

6] 细 谷 功 . 具体 上 必 抽象 一 世界 雁 变 林 文 昂 元 耕 知 性 D UL《< [M1]. 东京: 
dZERO, 2014. 











































































































































































































32 


YAGNI 


英 语 You Aren’t Going to Need It 
中 文 你 不 会 需要 它 





AAA 只 与 所 需 最 低 限度 的 代码 


不 能 以 “可 能 会 用 到 ”为 动机 编写 代码 。 我 们 要 在 需要 的 时 候 写 需 
要 的 代码 。 

人 们 不 可 能 预测 出 软件 的 变化 ， 写 出 超前 的 代码 。 我 们 一 定 要 明 
这 一 点 ， 坚 持 只 写 当 前 需要 的 代码 。 




















58 代码 无 法 预测 


即使 事先 写 好 了 一 大 堆 代 码 以 应 对 各 种 情况 ， 这 些 代 码 大 多 也 派 不 
上 用 场 。 
程 针对 的 是 特定 需求 ， 所 以 再 怎么 追求 通用 性 ， 总 有 无 法 满足 的 
情况 。 考 虑 到 代码 的 扩展 性 ， 有 时 人 们 会 把 自己 认为 有 用 的 东西 设计 进 
去 。 可 惜 这 些 预 想 大 多 不 会 成 真 。 不 能 成 真 ， 就 意味 着 浪费 了 时 间 。 

况且 将 扩展 性 纳入 考虑 的 范围 会 进一步 使 代码 变 得 复杂 。 无 用 的 代 
码 混在 其 中 ， 使 得 代码 的 可 读 性 变 低 ， 难 以 维护 。 

当然 ， 如 果 这 些 为 扩展 性 服务 的 代码 将 来 能 派 上 有 用场， 那么 它们 还 
是 有 价值 的 。 然 而 现实 不 可 能 如 此 理想 。 相 反 ， 随 着 时 间 的 流逝 ， 人 们 
会 忘记 这 些 没 用 的 代码 为 了 什么 而 存在 。 这 样 一 来 ， 当 初 费时 费力 想 出 
的 设计 就 没有 了 用 武之 地 ， 成 了 碍 事 的 垃圾 。 
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过量 只 与 当前 需要 的 代码 


比 起 通用 性 ， 我 们 更 应 该 重视 单纯 性 。 

先 把 通用 性 带 来 的 可 重复 使 用 的 特性 和 扩展 性 放 到 一 边 ， 将 “能 
用 ”这 一 点 放 到 第 一 位 。 

当 在 多 个 设计 方案 中 进行 选择 时 ,我 们 重点 要 看 的 是 设计 方案 的 单 
纯 性 ， 而 不 是 通用 性 。 不 要 选择 标榜 通用 性 的 复杂 方案 ， 要 选择 以 具体 
需求 为 基础 的 简单 方案 。 

很 多 时 候 ， 简 单方 案 的 通用 性 更 强 。 

即使 需求 增加 ， 功 能 需要 扩展 ， 简 单 的 代码 也 比 通用 的 复杂 代码 更 
容易 修改 。 


YAGNI 的 适用 范围 


除 代码 之 外 ，YAGNI 还 适用 于 软件 的 功能 。 
丰富 的 功能 看 上 去 很 吸引 人 ， 但 仅 赁 预想 创建 出 来 的 “没有 必要 
的 ”功能 不 但 没有 人 使 用 ， 还 会 令 软件 整体 的 使 用 方法 复杂 化 。 


DTSTTCPW 


DTSTTCPW 是 “Do The Simplest Thing That Could Possibly Work” 
的 缩写 ， 意 为 在 可 行 方案 中 选取 最 简单 的 方案 执行 。 其 含义 和 目的 都 与 
YAGNI 相同 。 

在 编程 中 ， 经 验 告诉 我 们 “今天 选择 简单 的 方案 执行 ， 等 明天 需要 
修改 代码 的 时 候 ， 再 花费 时 间 和 精力 进行 修改 ”要 比 “今天 选择 复杂 的 
方案 执行 ， 结 果 没 派 上 用 场 ”更 能 获得 好 的 结果 。 多 条 原则 都 表达 了 这 
样 的 观点 ， 足 以 证 明 其 正确 性 。 

不 过 ， 选 择 简单 的 一 方 并 没有 想象 中 那么 容易 。 人 们 很 难 不 去 思考 
明天 、 下 周 ， 甚 至 下 个 月 要 写 的 代码 。 
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但 是 ， 想 得 太 远 只 会 增加 代码 的 复杂 度 ， 提 高 修改 的 成 本 。 所 以 每 
次 编程 时 都 要 想 想 这 些 原 则 ， 让 自己 回 到 原点 。 
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PIE 


英 语 Program Intently and Expressively 


中 文 编程 要 表达 出 意图 





二 表达 出 代码 的 意图 











在 写 代码 时 ， 明 确 表达 意图 十 分 重要 ， 这 与 写 许 、 写 随笔 、 写 博客 
和 写 信和 是 一 个 道理 。 

这 是 因为 代码 是 写 给 人 看 的 ， 而 不 是 写 给 编译 器 看 的 。 

因此 ， 在 写 代码 时 要 在 表达 上 多 花心 思 ， 将 软件 运行 方式 直观 地 传 
达 给 阅读 代码 的 人 。 











ME 出 代码 是 唯一 的 线索 





代码 是 我 们 正确 、 完 整地 了 解 软件 运行 方式 的 唯一 线索 。 

软件 开发 过 程 中 虽然 会 创建 诸多 文档 ,但 这 些 文档 并 不 能 帮助 我 们 
正确 认识 软件 是 如 何 运行 的 。 

需求 定义 文档 只 描述 了 需要 什么 东西 。 

基本 设计 文档 只 描述 了 用 什么 样 的 软件 来 实现 需求 。 

详细 设计 文档 只 描述 了 成 品 软件 是 什么 样 的 结构 。 详 细 设计 文档 昌 
然 与 代码 最 接近 ， 但 代码 是 动态 变更 的 ， 而 详细 设计 文档 往往 做 不 到 同 
步 ， 更 何况 并 非 每 个 项 目 都 有 详细 设计 文档 。 所 以 说 详细 设计 文档 并 不 
是 百分之百 存在 且 百 分 之 百 有 用 的 。 

到 头 来 ,我 们 只 能 通过 阅读 代码 来 掌握 软件 的 运行 情况 。 因 此 ， 编 
写 可 读 性 高 的 代码 ， 用 代码 表达 意图 是 唯一 可 取 的 方法 。 
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li' 放 把 提高 代码 可 读 性 作为 第 一 要 务 





在 编写 代码 时 ， 我 们 要 重视 的 是 代码 的 可 读 性 ， 而 不 是 代码 的 易 
写 性 。 

读 代 码 的 次 数 远 比 写 代 码 的 次 数 多 。 代 码 只 写 一 次 ， 但 此 后 会 被 人 
多 次 阅读 。 所 以 ， 写 代码 的 时 间 远 没有 读 代码 的 时 间 长 。 包 括 自己 正在 
写 的 代码 ， 自 己 读 的 时 间 可 能 都 要 比 写 的 时 间 长 。 

因此 ,“ 读 代码 的 效率 ”应 优先 于 “ 写 代码 的 效率 "。 只 要 代码 的 可 
读 性 能 够 提高 ， 就 算 牺牲 写 代 码 的 效率 也 是 值得 的 。 只 要 有 人 使 用 软 
件 ， 代 码 就 会 一 直 存 活 下 去 ， 所 以 代码 的 寿命 往往 超 乎 我 们 的 想象 。 可 
读 性 高 的 代码 ， 其 价值 也 会 随 着 时 间 的 推移 不 断 累积 。 

“ 读 代 码 的 效率 ”同样 优先 于 “执行 代码 的 效率 "， 因 为 如 果 代 码 的 
可 读 性 较 高 ， 提 高 代码 的 执行 效率 也 会 变 得 容易 一 些 。 

将 代码 的 可 读 性 放 在 第 一 位 ， 就 意味 着 不 能 为 了 炫 夕 才华 而 写 一些 
让 人 难 懂 的 代码 。 刚 学 会 新 技术 时 ， 人 们 很 容易 落 入 陷阱 ， 明 知 学 会 的 
新 技术 用 不 上 还 想 炫 炊 一 下 。 不 能 让 人 读 懂 的 代码 不 是 好 代码 。 只 有 能 
够 向 读者 准确 传达 意图 的 代码 ， 才 是 能 够 帮 我 们 达到 目的 的 好 代码 。 

不 管 是 自己 写 的 代码 还 是 别人 写 的 代码 ， 只 要 我 们 在 阅读 的 过 程 中 
不 能 立刻 理解 ， 就 应 该 马上 对 其 进行 修改 ， 提 高 代码 的 可 读 性 。 久 而 久 
之 ,工作 就 能 顺利 开展 下 去 了 。 




























































































be 如 免 打 地 女 式 的 开发 


打 地 鼠 是 一 个 很 有 名 的 游戏 。 玩 家 手持 木 杷 ， 敲 击 从 土 中 露出 脑袋 的 
地 鼠 。 没 人 知道 地 鼠 下 次 会 从 哪里 外 出 来 ， 这 正 是 该 游戏 的 乐趣 所 在 。 
然而 在 软件 开发 中 ， 这 并 不 是 一 件 好 事 。 修 改 一 个 会 在 各 处 随机 出 
现 问题 的 软件 毫 无 乐趣 可 言 。 
软件 的 项 目 经 理会 面临 各 种 催促 交付 的 压力 ， 对 他 们 来 说 ， 时 间 非 
常 重要 。 因 此 ， 他 们 更 倾向 于 牺牲 代码 的 质量 来 提高 实现 功能 的 速度 。 
这 就 是 打 地 鼠 式 的 开发 。 编 写 可 读 性 高 、 没 有 故障 的 高 质量 代码 
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( 和 测试 程序 ) 确实 需要 花费 很 多 时 间 ， 从 短期 来 看 是 一 种 损失 。 但 这 
样 做 能 够 避免 打 地 鼠 式 的 开发 ， 从 长 远 来 看 ， 利 大 于 次 。 


要 写 注释 

理想 的 代码 ， 是 可 读 性 高 到 没有 注释 也 能 读 懂 的 代码 。 

然而 ,代码 毕 竞 只 能 表达 “做 什么 ”和 “怎么 做 ”"。 要 表达 “为 什 
么 这 样 做 ”"， 还 需要 用 到 注释 。 

代码 文本 的 作用 是 与 读 代 码 的 人 进行 交流 。 为 了 使 交流 更 加 顺畅 ， 
我 们 还 要 把 注释 当成 一 种 交流 的 手段 。 我 们 在 写 代 码 时 要 找到 一 个 平衡 
点 ， 一 方面 要 让 代码 在 不 需要 注释 的 情况 下 能 被 人 理解 ， 一 方面 用 注释 
来 弥补 代码 表达 不 出 来 的 东西 。 




















E53 局 后 由 文学 编程 


























表达 意图 的 编程 中 有 一 个 终极 形态 ， 那 就 是 “文学 编程 ”( literate 
programming )。 

文学 编程 是 一 种 将 代码 本 身 当 作文 档 的 编程 方法 。 在 文学 编程 
用 于 描述 文档 的 语言 与 编程 语言 结合 在 了 一 起 。 

这 里 所 说 的 文档 是 对 程序 的 说 明 。 在 经 过 编译 之 后 ， 这 些 文档 就 成 
了 能 够 执行 的 软件 。 代 码 即 文档 ， 文 档 即 代码 。 

也 就 是 说 ， 在 文学 编程 中 ， 代 码 与 文档 并 不 分 开 编写 ， 二 者 会 编写 
在 一 个 文本 中 。 然 后 ， 生 成 程序 会 区 分 代码 部 分 和 文档 部 分 ， 将 二 者 分 
别 交 给 编译 器 和 文档 处 理 程序 来 处 理 。 

实现 这 一 功能 的 是 文学 编程 的 支持 软件 WEB。 这 个 工具 能 解析 以 
文学 编程 方法 写 出 的 代码 ， 生 成 ( weave ) 以 特定 形式 输出 的 文档 的 源 
文件 (TeX )， 同 时 生成 (tangle ) 可 供 一 般 编 译 器 使 用 的 源 代码 
(Pascal )。 
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WEB 


TeX Pascal 


|* | 编译 


以 文学 编程 的 方法 编写 代码 ， 可 以 让 代码 像 故 事 一 样 写 出 来 。 因 
此 ， 人 们 可 以 根据 上 下 文 轻松 读 懂 代 码 。 在 文学 编程 中 ， 代 码 的 描述 不 
受 语言 解释 右 的 约束 。 在 这 里 ， 代 码 可 以 像 文学 作品 一 样 写 出 来 。 

文学 编程 具有 以 下 优势 。 

































































@ 由 于 不 必 另 外 编写 文档 ， 所 以 程序 员 可 以 一 边 编程 一 边 描述 代码 
的 解释 性 内 容 及 代码 的 正当 性 依据 ， 这 就 使 程序 员 可 以 从 另 一 个 


角度 来 审视 代码 
@ 代码 离 相 关 说 明 的 位 置 很 近 ， 便 于 修改 。 人 和 修改 代码 后 ， 相 关 说 明 
也 能 及 时 得 到 更 新 


@ 保证 整个 代码 中 只 存在 一 个 文档 
. ea 含 普通 注释 不 会 描述 的 信息 (算法 的 说 明 、 正 当 性 依 
握 、 设 计 上 的 依据 等 ) 


软件 的 维护 阶段 最 能 体现 文学 编程 的 价值 。 由 于 可 以 直接 参考 丰富 
且 高 质量 的 说 明 信 息 ， 所 以 用 文学 编程 方法 写 出 的 代码 要 比 一 般 代码 更 
容易 维护 。 

然而 从 结果 来 看 ， 文 学 编程 的 编程 环境 并 没有 得 到 普及 。 这 是 因为 
与 其 他 编程 语言 相 比 ， 文 学 编程 写 代码 的 负担 更 重 。 

不 过 ,文学 编程 中 “代码 要 表达 作品 的 意图 ， 并 且 要 有 自我 说 明 的 
能 力 ” 这 一 观点 还 是 以 PIE 原则 的 形式 保留 了 下 来 。 
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SLAP 


英 语 Single Level of Abstraction Principle 


中 文 单一 抽象 层次 原则 





统一 代码 的 级 别 


在 编写 代码 时 ， 我 们 要 将 高 级 别 的 抽象 化 概念 和 低级 别 的 抽象 化 概 
念 分 离 。 

在 分 离 时 不 能 只 有 高 低 两 层 。 我 们 要 根据 功能 的 复杂 程度 对 抽象 化 
概念 进行 分 离 ， 然 后 统一 各 层 的 抽象 级 别 。 

也 就 是 说 ,我 们 要 根据 抽象 级 别 对 函数 进行 分 割 ， 并 且 将 同一 函数 
中 的 代码 统一 为 同一 个 抽象 级 别 。 

统一 各 抽象 级 别 之 后 ， 代 码 便 成 了 一 本 优秀 的 图 书 。 优 秀 的 图 书 结 
构 紧 次 ， 各 章节 的 分 割 与 排版 都 很 严谨 ， 通 读 下 来 能 获得 最 流畅 的 阅读 
体验 。 当 然 ， 我 们 也 可 以 将 其 视 为 参考 资料 ， 从 任意 位 置 开始 阅读 。 

统一 各 抽象 级 别 之 后 ， 代 码 就 可 以 像 图 书 一 样 供 人 阅读 了 。 高 级 到 中 
级 的 处 理 相 当 于 图 书 的 目录 ， 级 别 最 低 的 处 理 相 当 于 图 书 的 正文 。 
































function 高 级 () {// 1 级 目录 
中 级 1 () ; 
中 级 2 () ; 














} 
function 中 级 1 () {// 2 级 目录 -1 
低级 1 () ; 
低级 2 () ; 




















} 
function 低级 1 () {// 正文 内 容 
// 处 理 








} 
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function 低级 2() {// 正文 内 容 
// 处 理 





} 
function 中 级 2(){// 2 级 目录 -2 
低级 3 () ; 














} 
function 低级 3 () {// 正文 内 容 
WEE 











} 


ME 出 使 代码 具有 概括 性 和 可 读 性 








将 代码 分 割 成 级 别 统一 的 函数 ， 能 使 代码 具有 概括 性 和 可 读 性 。 也 
就 是 说 ， 函 数 一 览 起 到 了 目录 的 作用 ， 从 而 使 代码 拥有 概括 性 。 分 割 后 
的 函数 是 小 块 的 代码 ， 这 就 提升 了 代码 的 可 读 性 。 

代码 统一 之 后 ， 抽 象 度 相同 的 处 理 都 在 同一 个 地 方 。 于 是 ， 代 码 变 
得 更 加 顺畅 ， 更 容易 让 人 理解 。 

相反 ， 如 果 读 到 一 半 时 代码 的 抽象 度 突然 发 生 了 改变 ， 流 畅 感 就 
会 夏 然而 止 。 这 就 给 阅读 造成 了 障碍 ， 并 且 会 扰乱 我 们 对 前 面 代码 的 
理解 。 


将 函数 结构 化 


我 们 要 将 函数 结构 化 。 
将 处 理 转换 为 意图 清晰 、 由 抽象 化 级 别 一 致 的 多 个 步骤 组 成 的 函数 。 
将 函数 结构 化 之 后 ， 各 函数 的 处 理 将 以 调用 比 自己 低 一 个 级 别 的 函 
数 为 中 心 。 这 种 由 其 他 函数 的 调用 组 成 的 函数 称 为 复合 函数 ( composed 
method ee 
函数 要 尽量 小 。 如 果 想 通过 名 称 来 表达 意图 ， 那 么 即使 处 理 只 
> 也 可 以 写成 了 数 。 
男 外， 不 要 在 复合 函数 中 调用 不 同 抽象 级 别 的 函数 。 也 就 是 说 ,一 
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个 函数 中 不 能 既 有 “连接 数据 库 ” 这 种 低级 处 理 ， 又 有 “执行 业务 逻 
辑 ” 这 种 高 级 处 理 。 


SLAP 的 适用 范围 


除 函数 外 ，SLAP 还 适用 于 模块 等 结构 。 

在 优秀 的 软件 设计 中 ， 概 念 被 划分 为 多 个 级 别 ， 不 同 级 别 的 概念 会 
装 入 不 同 的 容器 中 。 

拿 面 向 对 象 中 的 类 设计 来 说 ， 容 器 是 抽象 类 和 它 的 继承 类 。 用 抽象 
类 存放 级 别 较 高 的 概念 ， 用 它 的 继承 类 存放 级 别 较 低 的 概念 ， 由 此 便 实 
现 了 SLAP。 

不 过 ， 此 时 要 确保 级 别 较 低 的 概念 只 存在 于 继承 类 ， 级 别 较 高 的 概 
念 只 存在 于 抽象 类 。 


实现 SLAP 的 步骤 


我 们 可 以 参考 写 文章 时 的 步骤 来 实现 SLAP。 

要 写 出 一 篇 优秀 的 文章 ， 关 键 在 于 将 “编写 内 容 ” 与 “设计 结构 ” 
这 两 件 事 分 开 来 做 。 

这 种 做 法 同样 可 以 套用 到 代码 的 编写 上 。 也 就 是 说 ， 将 编写 具体 
处 理 的 操作 和 统一 抽象 化 级 别 的 操作 视 为 两 个 不 同 的 工作 ， 分 别 以 不 同 
的 模式 去 实现 。 这 样 ， 我 们 操作 起 来 会 更 加 简便 ， 代 码 的 质量 也 会 得 到 
提升 。 





















































E33 导出 代码 与 图 书 











优秀 的 图 书 能 够 为 编写 优质 的 代码 提供 参考 。 这 里 我 们 对 图 书 的 构 
成 要 素 进行 分 析 ， 看 看 各 要 素 分 别 相当 于 代码 的 哪个 部 分 ， 研 究 一 下 如 
何 才能 写 出 优质 的 代码 。 
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e@ 序言 


图 书 的 序言 用 于 体现 该 书 的 主旨 ， 从 全 局 说 明 该 书 的 立意 。 
序言 部 分 在 代码 中 相当 于 文件 开头 的 注释 。 这 部 分 注释 负 
代码 描述 的 内 容 以 及 代码 所 属 的 项 目 。 


责 说 明 


目录 

图 书 的 目录 相当 于 代码 的 函数 一 览 。 

有 人 提倡 在 代码 的 开头 列 出 代码 中 所 有 的 函数 。 不 过 ， 考 虑 到 集 
成 开发 环境 以 及 编辑 器 的 函数 一 览 功 能 和 跳 转 功能 ， 这 一 做 法 其 
实 没 有 什么 必要 。 


部 分 

图 书 的 内 容 有 时 会 分 成 多 个 部 分 。 

在 某 些 情况 下 ， 代 码 也 可 以 分 割 成 多 个 部 分 ， 比 如 一 个 文件 中 描 
述 了 多 个 模块 ， 或 者 文件 内 的 函数 可 以 在 逻辑 上 分 成 多 个 组 等 。 
这 时 就 需要 用 注释 来 区 分 各 个 部 分 ， 明 确 表示 出 逻辑 上 的 分 段 。 
不 过 ， 在 一 个 文件 中 描述 过 多 的 内 容 并 不 是 明智 的 做 法 ， 因 为 这 
么 做 不 仅 会 使 内 容 变 得 混乱 ， 让 人 难以 理解 ， 还 会 给 文件 内 的 移 
动 操作 带 来 麻烦 。 

因此 ， 在 代码 量 较 多 的 情况 下 ， 分 多 个 文件 描述 会 比较 好 。 


SD 


时 
图 书 的 章 是 给 一 整 块 有 头 有 尾 的 内 容 添 加 一 个 标题 后 形成 的 。 
它 相 当 于 代码 中 的 函数 。 我 们 要 套用 SLAP 编写 结构 化 函数 。 


段落 

图 书 中 的 段落 相当 于 函数 中 的 代码 块 。 和 图 书 中 的 段落 一 样 ， 函 
数 中 的 代码 块 也 要 用 空 行 来 区 分 。 

各 兄 数 的 逻辑 由 语句 罗列 而 成 。 我 们 要 将 语句 按照 逻辑 区 分 成 
块 ， 通 过 空 行 来 和 后 面 的 代码 进行 区 分 。 空 行 在 语法 上 没有 意 
义 ， 它 仅仅 用 于 提高 代码 的 可 读 性 。 


@ 正文 


图 书 中 的 一 句 句 话 相 当 于 代码 中 的 一 条 条 语句 。 与 写 文 章 一 样 ， 为 
了 便于 读者 理解 ， 语 句 要 尽量 简短 。 一 条 语句 只 描述 一 件 事情 。 


e 注释 、 索 引 





一 些 图 书 也 有 注释 和 上 索引， 但 代码 中 不 需要 有 相应 的 内 容 。 集 成 
开发 环境 以 及 编辑 器 的 跳 转 和 搜索 功能 可 以 满足 这 部 分 需求 。 


oO 
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OCP 


英 语 Open-Closed Principle 
中 文 开 闭 原则 





向 代码 的 修改 不 相互 影响 


我 们 要 让 代码 同时 满足 对 扩展 开放 、 对 修改 关闭 这 两 个 属性 。 

对 扩展 开放 表示 代码 的 行为 可 以 扩展 。 

对 修改 关闭 表示 当 对 代码 的 行为 进行 扩展 时 ， 其 他 代码 完全 不 会 受 
到 影响 。 

代码 如 果 同 时 满足 这 两 个 属性 ， 就 可 以 在 不 影响 既 有 代码 的 前 提 下 
扩展 功能 。 











2 出 灵活 应 对 代码 的 修改 


不 论 什么 软件 ， 只 要 它 还 在 生命 周期 内 ， 就 一 定 会 发 生变 化 。 而 且 
软件 的 寿命 远 比 我 们 想象 的 要 长 。 因 此 ， 我们 设计 出 的 软件 要 既 能 适应 
变化 ， 又 能 保持 长 期 的 稳定 。 

这 就 要 求 代码 能 够 灵活 应 对 变化 ， 对 扩展 开放 ， 对 修改 关闭 。 如 果 
能 够 满足 上 述 要 求 ， 就 算 需 求 发 生变 化 ， 我 们 只 要 给 代码 添加 新 的 行 
为 ， 就 能 毫 无 风险 地 完成 对 软件 的 修改 。 

如 果 设 计 得 太 过 和 死板， 那么 一 个 小 小 的 修改 也 会 影响 到 所 有 与 其 存 
在 依赖 关系 的 部 分 。 死 板 的 设计 是 非常 脆弱 的 。 
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壹 久 量 给 代码 设置 接口 


我 们 要 给 代码 添加 接口 。 
在 设计 具有 某 项 功能 的 模块 时 ， 如 果 让 模块 的 使 用 者 客户 端 直接 调 
用 模块 的 提供 者 服务 器 ， 我 们 就 可 以 说 这 个 设计 是 死板 的 ， 因 为 在 这 种 
情况 下 如 果 想 使 用 其 他 服务 器 ， 还 需 修 改 客户 端 。 
























































使 


客户 端 = | 服务 器 























因此 ,我 们 要 在 客户 端 与 服务 器 之 间 为 模块 的 使 用 者 设置 “客户 端 
接口 "。 这 个 客户 端 接口 由 服务 带 实 现 。 




















使 用 


容 户 端 。 | 一 | ”客户 端 接口 


















































这 样 一 来 ， 在 添加 拥有 新 功能 的 服务 右 时 ， 只 要 该 服务 右上 有 客户 
端 接口 ， 客 户 端 就 可 以 直接 调用 新 服务 器 ,我 们 就 不 用 再 修改 代码 了 。 
也 就 是 说 ,我 们 可 以 在 不 修改 当前 代码 的 前 提 下 添加 新 功能 。 


OCP 的 适用 范围 


OCP 的 适用 范围 是 有 限 的 ， 我 们 不 能 要 求 所 有 代码 都 遵循 OCP。 
之 所 以 这 么 说 ， 是 因为 在 没有 发 生变 更 的 情况 下 ，OCP 只 会 让 代码 变 得 
复杂 、 元 长 。 

要 想 避 免 滥用 OCP， 我 们 就 需要 做 到 不 过 分 预 估 变 更 内 容 。 然 而 ， 
人 是 不 可 能 完全 正确 地 对 变更 内 容 进 行 预 估 的 。 


























47 





对 此 ,我 们 可 以 先 不 管 OCP， 等 内 容 实际 发 生变 更 后 再 进行 处 理 。 
也 就 是 说 ， 先 硕 出 去 挨 第 一 发 子弹 〈 变 更 )， 然 后 进行 修改 ， 从 而 避免 
以 后 在 同一 个 位 置换 子弹 。 
使 用 OCP 的 关键 在 于 预 估 ， 不 过 这 里 预 估 的 不 是 变更 内 容 ， 而 是 
可 能 会 发 生变 化 的 部 分 。 以 图 形 处 理 软件 为 例 ， 图 形 的 种 类 就 是 一 个 容 
易 发 生变 化 的 部 分 ， 这 一 点 我 们 不 难 想到 。 我 们 虽然 不 知道 下 次 要 添加 
的 是 五 边 形 还 是 圆 形 ， 但 可 以 预 佑 出 图 形 的 种 类 会 发 生变 化 。 找 出 可 能 
发 生变 化 的 部 分 ， 将 该 部 分 藏 到 接口 后 面 ， 这 种 手法 叫 作 “流动 元 素 的 
胶 才 化 ”。 


OCP 的 实现 与 设计 


面向 对 象 的 多 态 性 是 实现 OCP 的 代表 技术 。 

不 过 ，OCP 并 不 专属 于 面向 对 象 。 比 如 编译 器 在 链接 时 ， 如 果 能 切 
换 要 链接 的 库 ， 则 可 以 在 非 面向 对 象 语言 中 实现 OCP。OCP 的 适用 范 
围 不 受 语言 的 限制 。 

另外 ,在 设计 模式 这 类 设计 手法 中 ， 有 很 多 设计 模式 可 以 用 来 实 
现 OCP， 具 有 代表 性 的 有 Strategy、Observer、Template Method 和 


Decorator。 


E33 局 二 由 受 保护 变化 


GRASP ( General Responsibility Assignment Software Pattern， 通 用 职 
责 分 配 软 件 模 式 ) 是 一 种 职责 驱动 设计 方法 。 该 方法 中 介绍 了 一 个 名 为 
“ 受 保护 变化 ”( protected variations ) 的 设计 模式 。 这 个 设计 模式 具体 来 
说 就 是 识别 出 稳定 部 分 与 不 稳定 部 分 的 交界 点 ， 然 后 用 稳定 的 接口 将 交 
界 点 包 右 起 来 。 

也 就 是 说 ， 不 稳定 部 分 中 的 不 稳定 因素 导致 变更 多 发 ， 受 保护 变化 
则 用 接口 这 一 防护 墙 将 变更 带 来 的 影响 抵御 在 外 。 这 样 一 来 ， 接 口 就 像 
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防止 火灾 蔓延 的 防火 墙 和 防止 水 漫 四 方 的 防水 堤 一 样 ， 保 护 软件 不 受 变 
更 的 影响 。 
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名 字 很 重要 


英 语 Naming is important 





命名 是 代码 最 重要 的 课题 


在 编程 中 ,我们 要 将 命名 视 为 最 重要 的 课题 ,谨慎 对 待 。 
“命名 ”这 一 行为 和 它 的 产物 “名 字 ” 都 具有 非常 重要 的 价值 。 














e 命名 
取 了 一 个 合适 的 名 字 意 味 着 元 素 被 正确 理解 并 被 正确 地 设计 了 出 
来 。 相 反 ， 如 果 取 的 名 字 不 合适 ， 就 证 明 程 序 员 还 没有 充分 理解 
该 元 素 的 作用 。 
取 了 一 个 合适 的 名 字 就 表示 设计 已 经 完成 了 一 大 半 。 


e 名 字 本 身 
程序 员 之 间 通 过 代码 进行 交流 时 ， 名 字 传 递 的 信息 是 最 多 的 。 
写 代码 的 人 和 读 代码 的 人 很 少 能 站 在 一 起 实时 进行 对 话 。 程 序 员 
之 间 大 多 通过 代码 进行 交流 ， 一旦 名 字 不 够 贴切 ， 代 码 上 的 沟通 


就 会 出 现 障碍 。 
为 了 让 这 种 非 实时 对 话 能 够 顺畅 进行 ， 我 们 必须 最 大 限度 地 在 名 


BME 对 名 字 是 面向 代码 阅读 者 的 “用 户 界面 ” 





名 字 是 面向 代码 阅读 者 的 “用 户 界面 "。 各 元 素 都 有 适当 名 字 的 代 














码 能 有 效 传达 其 意图 ， 让 人 充分 理解 某 个 东西 是 怎样 做 出 来 的 。 
以 给 函数 命名 为 例 ， 名 字 恰 当 易 懂 的 函数 能 通过 名 字 表 达 其 职责 ， 
这 有 助 于 隐藏 函数 的 内 部 处 理 。 从 结果 来 看 ， 有 以 下 好 处 。 











tt 


@ 在 阅读 代码 时 ， 只 看 函数 名 就 能 大 致 掌握 其 内 部 处 理 ， 因 此 可 以 
跳 着 阅读 内 部 代码 

@ 在 编写 代码 时 ， 函 数 名 能 帮助 我 们 理解 该 函数 的 目的 及 用 法 ， 使 
函数 调用 变 得 简单 。 对 编写 完 的 代码 来 说 ， 恰 当 的 名 字 起 到 了 说 
明 作 用 ， 使 代码 的 可 读 性 大 大 提高 








相反 ， 名 字 星 涩 难 懂 的 函数 会 给 代码 方面 的 作业 增加 很 大 的 负担 。 
有 具体 来 说 有 以 下 几 点 。 














@ 在 阅读 代码 时 ， 如 果 无 法 通过 函数 名 了 解 处 理 内 容 ， 就 必须 解析 
函数 的 内 部 代码 。 也 就 是 说 ， 读 代码 的 人 要 被 迫 深 入 阅读 代码 。 
如 果 函 数 谱 套 层 数 不 是 很 多 倒 也 还 好 ， 但 随 着 层 数 的 增加 ， 程 序 
员 的 负担 会 逐渐 加 重 

@ 在 编写 代码 时 ， 如 果 无 法 通过 函数 名 进行 各 种 判断 ， 就 需要 对 函 
数 内 部 进行 解析 。 即 便 大 费 周章 完成 了 代码 的 编写 ， 代 码 也 会 因 
所 调用 的 函数 的 名 字 不 当 而 看 上 去 支离破碎 ， 变 得 难以 读 懂 





在 读 写 代 码 时 ， 程 序 员 的 大 脑 处 于 超 负荷 运转 状态 。 程 序 员 在 面 对 
代码 时 ， 如 果 大 脑 被 “代码 是 怎么 运行 的 ”这 一 问题 占 满 ， 就 无 法 思考 
其 他 问题 ， 导 致 工作 停滞 不 前 。 
程序 员 并 不 是 因为 想 读 代码 才 去 读 的 。 在 充分 理解 代码 之 后 对 其 进 
行 修改 或 添加 功能 才 是 他 们 真正 的 目的 。 在 阅读 代码 时 ， 混 乱 的 名 字 会 
占用 所 有 的 脑 部 资源 ， 妨 碍 原本 应 该 进行 的 作业 ， 使 程序 员 无 法 着 手 处 
理 问 题 。 

琢磨 名 字 需 要 花费 很 多 精力 。 要 想 取 一 个 恰当 的 名 字 ， 我 们 得 有 强 
大 的 思考 能 力 ， 还 要 舍得 花 时 间 。 相 反 ， 随 便 取 一 个 名 字 不 仅 不 会 影响 
函数 的 运行 ， 还 能 节约 时 间 。 
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但 是 ,不 恰当 的 名 字 会 让 代码 “负债 ”。 此 后 ， 只 要 代码 还 在 使 用 ， 





读 代码 的 人 、 用 代码 的 人 都 将 受到 负面 影响 。 


写 代码 前 先决 定名 字 


编程 要 先 从 名 字 入 手 。 先 给 代码 中 会 出 现 的 各 个 元 素 取 一 个 能 准确 


表达 意 


图 的 名 字 。 








在 编写 代码 的 过 程 中 也 要 时 常 站 在 代码 使 用 者 和 阅读 者 的 角度 命 




















名 。 


@ 名 字 中 要 尽量 多 包含 信 





具体 来 说 ， 我 们 要 注意 以 下 几 点 。 


息 。 将 名 字 视 为 简短 的 注释 有 助 于 将 必要 
的 信息 添加 进去 。 可 以 多 准备 几 个 名 字 ， 从 中 选择 最 合适 的 一 
个 。 这 样 能 进一步 提高 名 字 的 质量 
名 字 不 能 有 歧义 。 命 名 之 后 ， 多 问 自己 几 遍 这 个 名 字 是 否 存 在 歧 
义 。 要 想 减 少 歧 义 ， 就 需要 了 解 并 遵循 各 编程 语言 的 习惯 
名 字 说 明 的 是 效果 和 目的 ， 而 不 是 手段 。 如 果 所 取 名 字符 合 这 一 
条 件 ， 读 代码 和 使 用 代码 的 人 就 不 用 在 理解 代码 内 容 上 花费 太 多 
时 间 
可 以 通过 先 写 测试 程序 后 写 处 理 的 方式 检查 一 下 自己 取 的 名 字 是 
否 合 适 。 这 样 能 帮助 我 们 从 使 用 者 的 角度 来 审视 名 字 合 适 与 否 
名 字 要 能 念 出 来 。 除 了 便于 在 现实 对 话 中 使 用 之 外 ， 能 念 出 来 的 
名 字 还 可 以 减轻 阅读 代码 时 大 脑 的 负担 
名 字 要 能 搜索 出 来 。 名 字 如 果 是 一 个 字母 或 是 一 个 数字 ， 搜 索 时 
就 会 在 代码 中 产生 无 数 个 结果 。 这 会 给 代码 解析 带 来 额外 的 负担 





避免 心理 映射 


东西 ， 
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将 外 界 信息 转换 为 记忆 中 原 有 形象 的 过 程 称 为 心理 映射 。 
读 代码 的 人 看 到 某 元 素 名 字 后 需要 先 在 心里 把 它 转换 成 自己 知道 的 





这 个 过 程 就 是 心理 映射 ， 我 们 应 极力 避免 这 种 情况 发 生 。 对 集中 





注意 力 追 踪 代 码 流向 的 程序 员 而 言 ， 心 理 映射 会 给 大 脑 带 来 极 大 的 负 





担 ， 分 散 注意 力 。 


心理 映射 常 发 生 在 使 用 了 不 合乎 规定 或 问题 领域 之 外 的 术语 等 情况 
下 。 代 码 中 若 使 用 了 独创 的 名 字 ， 读 代码 的 人 就 必须 先进 行 心理 映射 才 





能 理解 元 素 表达 的 意思 。 因 此 ， 





我 们 要 尽 可 能 地 用 标准 术语 来 命名 元 





素 。 相 比 独创 的 名 字 ， 标 准 术语 更 能 获得 大 家 的 共识 ， 从 而 减轻 读 写 双 


方 的 负担 。 


另外 ,在 使 用 仅 有 一 个 字母 的 变量 名 〈 循环 计数 器 除外 ) 时 也 会 发 








生 心 理 映射 。 一 个 字母 的 变量 名 只 


4 是 一 个 占 位 符 ， 读 代码 的 人 需要 在 心 








里 将 其 转换 成 相应 的 术语 才能 理解 。 


程序 员 的 能 力 是 用 来 为 用 户 





创造 价值 的 。 在 命名 方面 炫耀 知识 是 多 

















余 之 举 。 我 们 应 该 使 用 大 家 能 理 


;二 明 环 回 检测 


一 种 叫 作 “名 字 可 逆 性 ” 
es 
要 想 满足 这 一 条 件 ， 就 需要 


pe se, 


的 命名 思路 。 该 思路 主张 名 字 必 须 能 还 





进行 环 回 检测 。 先 通过 内 容 的 说 明文 本 


来 想 名 字 ， 青 通过 名 字 倒 推出 说 明文 本 。 按 照 说 明文 本 、 名 字 、 说 明文 


本 的 顺序 绕 一 圈 回 来 ( 环 回 ) 后 ， 





如 果 说 明文 本 一 致 ， 那 这 个 名 字 就 是 





好 名 字 ， 如 果 不 一 致 就 需要 我 们 注意 了 
这 里 来 举 一 个 例子 。 我 们 先 通 过 说 明文 本 来 想 名 字 。 说 明文 本 的 内 
容 是 “一 种 用 语音 来 操作 软件 的 功能 ”。 











e 语音 识别 功能 ( x ) 
这 个 名 字 没 有 表达 出 识别 语 
人 们 容易 把 它 理 解 成 一 种 通 


e 语音 操作 功能 (和 A) 
这 个 名 字 没有 表达 出 语音 
成 一 种 操作 语音 的 功能 














语音 后 通过 语音 进行 操作 的 部 分 。 因 此 
过 语音 输入 数据 的 功能 


和 操作 之 间 的 关系 。 人 们 容易 把 它 理解 
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由 此 可 以 看 出 ， 直 接 使 用 原 说 明文 中 的 单词 并 不 能 达到 理想 的 
效果 。 


e@ 语音 控制 功能 (A) 
这 个 名 字 听 起 来 让 人 觉得 该 功能 是 一 种 对 语音 加 以 限制 的 功能 。 


e 语音 命令 功能 ( 〇 ) 
Eee 但 “命令 ”可 能 会 被 解释 为 “输出 语 
音 ” 是 “输入 语音 ”。 


? 
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少数 拥有 特殊 嗅觉 的 人 能 够 发 现 全 新 事物 ， 
邮 但 他 们 并 非 有 独创 性 的 人 。 
电 真正 有 独创 性 的 人 拥有 一 双 慧 眼 ， 
他 们 能 将 众人 眼中 的 旧事 物 、 人 尽 尼 知 的 事物 ， 
大 多 数 人 觉得 不 值 一 提 、 熟 视 无 睹 的 事物 ， 
视 作 新 新 的 事物 。 


一 龙灯 


编程 理论 


英 语 A theory of programming 





有 指导 编程 的 思想 


在 编程 的 过 程 中 ， 人 们 最 重视 的 莫 过 于 编写 出 高 质量 的 代码 。 

高 质量 的 代码 是 指 拥 有 多 种 扩展 方法 、 不 存在 多 余 要 素 、 可 读 性 
高 、 易 于 理解 的 代码 。 

编程 中 有 一 套 理论 专门 用 来 指导 人 们 实现 这 种 高 质量 的 代码 。 该 理 
论 由 以 下 三 个 思想 作为 支撑 。 











在 追求 高 质量 代码 的 过 程 中 ， 这 些 思想 左右 着 我 们 的 每 一 个 决定 。 


ELEA 将 编程 理论 展示 的 思想 作为 技术 的 选择 基准 








编程 在 不 同 的 问题 领域 有 不 同 的 技术 和 模式 。 

虽然 不 能 和 否认 理解 和 掌握 技术 的 重要 性 ， 但 单纯 的 学 习 只 能 帮助 我 
们 了 解 技术 的 表面 ， 并 不 能 帮助 我 们 真正 学 会 使 用 这 项 技术 。 

编程 中 解决 问题 的 方式 是 就 事 论 事 。 由 于 每 次 出 现 的 问题 都 不 相 
同 ， 所 以 如 果 不 先 找 出 问题 所 在 ， 我 们 就 无 法 选择 合适 的 技术 来 使 用 。 
要 想 熟 练 掌握 一 项 技术 ， 就 得 明白 为 什么 要 使 用 这 项 技术 、 这 项 技术 有 
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什么 价值 ， 以 及 我 们 应 ee 
此 时 就 需要 用 到 编程 理论 了 。 编 程 理论 所 展示 的 思想 就 是 使 用 各 项 
技术 的 理由 。 




















过 六 个 原则 将 编程 理论 展示 的 思想 应 用 于 代码 


我 们 要 把 编程 理论 展示 的 思想 用 作 判 断 基准 。 这 样 做 可 以 更 加 准确 
地 判断 技术 和 方法 适用 与 否 。 在 把 这 些 思 想 应 用 于 代码 的 过 程 中 ， 我 们 
可 能 会 发 现 一 些 新 的 方法 。 

不 过 ， 把 思想 直接 应 用 于 实际 编程 未 免 有 些 抽 象 ， 所 以 我 们 需要 一 
个 “桥梁 ”来 连接 思想 与 编程 。 这 里 有 六 个 原则 可 以 充当 二 者 之 间 的 桥梁 。 





























@ 效应 局 部 化 

@ 重复 最 少 化 

@ 逻辑 与 数据 的 一 体 化 
@ 对 称 性 

@ 声明 式 表达 

@ 变动 率 


关于 这 三 个 思想 和 六 个 原则 ， 笔 者 会 在 后 面 详细 进行 讲解 。 


3 有 视点 


视点 是 我 们 使 用 某 项 技术 时 应 该 考虑 的 内 容 。 视 点 是 一 种 看 待 事物 
的 方式 ， 它 能 让 我 们 的 思想 紧 贴 当前 正在 处 理 的 问题 。 
以 下 几 点 内 容 都 属于 视点 。 














@ 解决 方案 应 满足 的 需求 (例如 需要 进程 间 通 信 等 ) 

@ 课题 中 包含 的 限制 (例如 进程 间 通 信 必 须 符合 协议 标准 等 ) 

@ 解决 方案 需要 具备 的 特性 ( 例如 便于 添加 功能 、 添 加 的 功能 不 影 
响 现 有 功能 等 ) 
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根据 这 些 视 点 ， 我 们 能 从 各 个 角度 探讨 课题 ， 能 更 深入 地 把 握 


不 过 ， 视 点 与 视点 之 间 可 能 是 相辅相成 的 ， 也 可 能 是 互相 排斥 的 。 
我 们 要 做 的 是 掌握 各 视点 之 间 的 平衡 。 掌 握 了 各 视点 之 间 平 衡 的 方案 就 
是 该 课题 的 优秀 解决 方案 。 

我 们 在 选择 代码 的 实现 方法 时 ， 要 将 编程 理论 作为 视点 来 使 用 。 也 
就 是 说 ， 要 以 思想 为 “动机 "， 以 原则 为 “桥梁 ”来 选择 代码 的 实现 方法 。 








E33 后 后 加 呈现 有 的 工具 是 如 何 形 成 的 














程序 员 需 要 使 用 信息 处 理 技 术 这 一 工具 来 解决 各 种 各 样 的 问题 。 















































这 时 ， 了 解 工 具 的 形成 过 程 就 成 了 程序 员 熟 练 使 用 工具 必 不 可 少 的 一 
个 条 件 。 

有 这 样 一 句 格言 一 一 形态 遵从 于 功能 。 这 句 话 是 说 工具 的 最 终 形 态 
由 目的 决定 。 


技术 也 是 一 种 工具 。 在 解决 问题 的 过 程 中 ， 技 术 经 过 反复 打磨 才 有 
了 今天 的 模样 。 如 果 掌 握 了 技术 的 使 用 步骤 而 不 了 解 它 的 演变 历史 , 那 
么 就 无 法 使 用 该 技术 真正 解决 问题 。 因 为 在 这 种 情况 下 ， 所 选 技术 与 要 
实现 的 目标 并 不 匹配 。 

另外 ,在 不 清楚 技术 为 何 而 用 的 情况 下 ， 对 于 知识 ,我们 也 只 会 
左 耳 进 右 耳 出 。 如 果 不 理解 使 用 技术 的 目的 ， 解决 问题 时 就 不 会 一 帆 
风 顺 。 

因此 ， 在 学 习 技 术 的 同时 ， 我 们 也 要 了 解 它 的 工作 原理 、 演 化 过 程 
和 设计 背景 。 只 有 这 样 ， 我 们 才 更 容易 达成 目的 。 

一 名 好 的 程序 员 ， 不 论 面 对 何 种 语言 、 工 具 、 技 术 和 问题 ， 都 会 花 
时 间 充 分 对 其 进行 理解 ， 然 后 开展 工作 。 在 编程 领域 ,“ 搞 不 懂 原 理 也 
没关系 ,代码 能 运行 就 好 ”“ 搞 不 懂 原 理 也 没关系 ， 故 障 排 除了 就 行 ” 
的 思想 必然 会 带 来 质量 方面 的 问题 。 所 以 在 编写 代码 之 前 ,一 定 要 尽 全 
力 去 理解 眼前 的 语言 、 工 具 、 技 术 和 问题 。 
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支撑 编程 理论 的 三 大 思想 
交 va 
JIL 


莫 语 Communication 





向 代码 是 交流 的 场所 





代码 也 是 一 种 给 人 看 的 文档 ， 而 文档 的 本 质 在 于 交流 。 
在 编程 中 ， 良 好 的 交流 意味 着 读 代码 的 人 能 够 理解 、 修 改 和 使 用 
代码 。 














顺利 的 开发 源 于 顺利 的 交流 

















软件 开发 的 大 部 分 成 本 是 在 开发 完成 后 产生 的 。 这 部 分 成 本 就 是 维 
护 成 本 。 

要 想 节 约 维护 成 本 ， 就 需要 提高 代码 的 可 读 性 。 这 是 因为 程序 员 之 
间 需 要 通过 代码 进行 交流 。 

读 代码 的 时 间 远 多 于 写 代 码 的 时 间 。 软 件 从 开发 到 寿终正寝 ， 期 间 
有 很 多 人 一 遍 又 一 遍地 读 其 中 的 代码 。 

此 外 ， 除 了 在 维护 阶段 需要 读 代码 ， 在 开发 阶段 程序 员 也 需要 一 边 
回顾 前 面 的 代码 一 边 编写 新 代码 。 通 过 代码 ， 程 序 员 与 片刻 之 前 的 自己 
实现 了 交流 。 




















153A5; 坊 从 代码 阅读 者 的 角度 出 发 


要 想 通 过 代码 取得 良好 的 交流 效果 ， 我 们 在 写 代 码 时 就 得 站 在 代码 
阅读 者 的 角度 思考 。 
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在 刚 开 始 编写 代码 时 ， 我 们 的 思维 很 容易 停留 在 如 何 编写 出 能 让 
计算 机 正常 处 理 的 代码 上 。 此 时 我 们 不 妨 改变 一 下 视角 ， 思 考 他 人 是 如 
何 看 待 这 段 代码 的 。 这 样 一 来 ， 我 们 便 能 从 新 的 角度 审视 问题 ， 寻 找 解 
决 方案 。 

把 思考 的 重点 从 计算 机 转移 到 代码 阅读 者 的 号 上 ， 就 是 所 谓 的 换 位 
思考 。 代 码 不 仅 是 输入 到 编译 器 和 解释 器 中 的 信息 ， 也 是 写 给 人 看 的 
“文章 ”。 我 们 要 重视 代码 在 交流 方面 的 作用 。 
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支撑 编程 理论 的 三 大 思想 @ 
简洁 


英 语 Simplicity 





消除 代码 的 复杂 性 


对 代码 而 言 ， 简 洁 就 是 消除 了 “多 余 的 复杂 性 ”后 的 状态 。 这 里 
所 说 的 “多 余 的 复杂 性 ”不 是 指 反映 了 目标 (代码 要 达成 的 目的 ) 复杂 
程度 的 复杂 性 ， 而 是 指 在 修改 代码 的 过 程 中 遗留 下 来 的 痕迹 所 带 来 的 
复杂 性 。 














ze 代码 的 复杂 性 是 罪魁 祸首 


“多 余 的 复杂 性 ”不 具有 任何 价值 。 这 类 复杂 性 会 阻碍 代码 正常 运 
行 ， 提 高 修改 代码 的 难度 ， 损 害 软件 的 价值 。 它 会 给 代码 埋 下 祸根 。 

消除 “多 余 的 复杂 性 ”可 以 让 代码 变 得 简洁 。 这 样 一 来 ， 阅 读 、 使 
用 、 修 改 代 码 的 人 就 能 快速 理解 代码 。 简 洁 的 代码 还 能 大 幅 降低 故障 发 
生 的 概率 。 

















过 5 习 分 清 代码 中 的 “ 玉 ” 与 “ 石 ” 


要 想 让 代码 保持 简洁 ， 我 们 就 需要 将 代码 中 的 “ 玉 ” 与 “ 石 ”明确 
区 分 开 来 。 在 设计 时 ， 将 代码 的 本 质 部 分 ( 玉 ) 放 在 显眼 的 位 置 ， 保 证 
其 他 元 素 ( 石 ) 不 会 混入 其 中 。 

简洁 能 给 交流 带 来 好 的 影响 。 消 除 多 余 的 复杂 性 后 ， 留 下 来 的 本 质 











02 





部 分 会 更 加 显眼 ， 代 码 也 变 得 更 易于 理解 。 这 就 有 利于 提高 交流 的 效 
率 。 同 样 ， 重 视 交流 ， 从 他 人 的 角度 看 问题 ， 能 够 帮助 我 们 判断 出 应 该 
剔除 哪些 东西 ， 从 而 提高 简化 代码 的 效率 。 

不 过 ， 简 洁 与 交流 偶尔 也 会 发 生 冲突 。 过 度 简 洁 会 使 代码 变 得 难以 
理解 。 在 遇 到 这 种 情况 时 ， 我 们 就 需要 牺牲 一 部 分 简洁 性 ， 把 交流 放 在 
优先 的 位 置 。 
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支撑 编程 理论 的 三 大 思想 加 
灵活 性 


英 语 Flexibility 





I 代码 易于 修改 


代码 的 灵活 性 是 指 修改 代码 的 难 易 程度 。 

“灵活 ”是 指 在 添加 新 代码 的 时 候 ， 已 有 代码 能 够 不 受 影 响 、 不 
产生 冲突 、 不 出 现 排斥 ， 在 保证 自身 不 遭 到 破坏 的 前 提 下 灵活 地 接纳 新 
代码 。 














2 出 代码 必然 会 被 修改 


代码 早晚 会 被 修改 。 因 此 ， 易 于 修改 、 有 具有 灵活 性 成 了 代码 的 必 备 
条 件 。 

软件 开发 并 不 是 在 软件 发 布 之 后 就 结束 了 。 为 了 持续 向 用 户 提供 服 
务 ， 发 布 后 我 们 还 要 对 软件 进行 维护 ， 比 如 修复 故障 、 调 整 功能 、 添 加 
新 功能 等 。 

修改 代码 的 难 易 程度 关系 到 维护 工作 能 否 顺 利 进 行 。 












































过, 恒 提高 代码 的 可 扩展 性 


要 想 让 代码 具有 灵活 性 ， 就 要 保证 代码 易于 扩展 且 扩 展 时 不 会 波及 
无 关 的 元 素 。 

不 过 ， 灵 活性 是 一 把 双 刃 剑 。 代 码 易 于 修改 自然 是 好 事 ， 但 灵活 性 
往往 会 成 为 将 复杂 的 代码 或 设计 正当 化 的 借口 。 不 能 以 牺牲 简 尘 性 为 前 
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提 来 提高 灵活 性 ， 因 为 多 余 的 灵活 性 是 无 用 的 ， 为 这 种 灵活 怕 
码 到 头 来 很 可 能 成 为 一 堆 带 来 多 余 复杂 性 的 无 用 代码 。 


E 服 务 的 代 





为 了 写 出 灵活 且 简 洁 的 代码 ， 我 们 需要 克制 住 展现 小 技巧 的 欲望 。 
相 较 于 通过 设计 自 上 而 下 地 获取 灵活 性 ， 从 确保 简洁 出 发 ， 通 过 单元 测 

















试 自 下 而 上 地 获取 灵活 性 会 更 好 。 
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实现 编程 理论 的 六 个 原则 QD 


效应 局 部 化 


英 语 Local consequences 





) 


效 


应 局 部 化 中 的 “效应 ”是 指 修改 带 来 的 影响 。 

改 应 局 部 化 是 指 将 修改 带 来 的 影响 控制 在 局 部 。 

效应 局 部 化 是 一 个 很 重要 的 原则 。 围 绕 该 原则 产生 了 许多 技术 ， 模 
块 化 就 是 其 中 之 一 。 模 块 化 技术 的 目标 之 一 就 是 让 修改 模块 所 带 来 的 影 
啊 停 留 在 该 模块 的 内 部 。 








sr 





| 


入 | 








多 更 易于 修改 和 确认 





在 效应 非 局 部 化 的 情况 下 ， 某 处 修改 会 对 其 他 完全 不 相关 的 地 方 造 
影响 ， 使 修改 成 本 大 幅 增加 。 

这 时 如 果 知 道 哪些 地 方 受到 了 影响 ， 或 许 还 有 救 。 然 而 在 大 部 分 情 
况 下 ， 我 们 对 此 是 一 无 所 知 的 。 这 时 就 得 先 花 时 间 排 查 影响 范围 。 

但 在 效应 局 部 化 的 情况 下 ， 我 们 需要 阅读 的 代码 以 及 修改 所 带 来 的 
影响 都 会 限制 在 一 定 的 范围 内 。 

男 外 ， 效 应 局 部 化 还 有 让 交流 更 加 顺畅 的 效果 。 在 效应 局 部 化 的 情 
况 下 ,程序 员 只 要 理解 当前 阶段 所 涉及 的 代码 即 可 ， 不 需要 一 次 性 掌握 
所 有 代码 。 























dl 
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志恒 整合 关系 紧密 的 代码 


在 编写 代码 时 ， 要 让 关系 紧密 的 代码 集中 在 一 起 ， 同 时 保证 关联 性 
较 弱 的 代码 不 互相 依赖 。 为 此 ， 我 们 需要 将 关系 紧密 的 代码 集中 起 来 实 
现 模 块 化 。 

从 关联 性 的 角度 来 看 ， 我 们 要 格外 注意 相互 频繁 调用 的 模块 。 模 块 
之 间 相 互 频繁 调用 通常 表明 原本 应 该 放 在 一 起 的 要 素 被 分 别 放 在 了 不 同 
的 模块 中 。 

这 种 时 候 就 需要 让 合适 的 单一 模块 来 实现 功能 ， 或 者 将 模块 功能 更 
合 在 一 起 ， 或 者 重新 创建 一 个 模块 来 实现 相应 的 功能 ， 总 之 要 保证 单一 
功能 的 密集 性 。 
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实现 编程 理论 的 六 个 原则 加 
重复 最 少 化 


英 语 Minimize repetition 





消除 重复 


重复 最 少 化 ， 就 是 指 极力 消除 重复 。 
许多 技术 都 以 实现 重复 最 少 化 为 目标 ， 函 数 化 技术 就 是 其 中 之 一 。 
该 技术 将 重复 的 逻辑 函数 化 ， 整 合成 一 段 共享 代码 来 使 用 。 














IEA 汪 将 修改 举 来 的 影响 局 部 化 


重复 的 代码 不 符合 效应 局 部 化 原则 ， 增 加 了 修改 成 本 。 

比如 ， 当 通过 复制 粘贴 让 同一 段 代 码 出 现在 多 个 位 置 时 ， 如 果 有 一 
个 地 方 进行 了 修改 ， 我 们 就 必须 检查 其 他 地 方 ， 判 断 各 处 是 否 需 要 修 
改 。 这 个 “判断 ”很 难 把 握 ， 并 不 是 全 部 替换 就 万 事 大 吉 了 。 而 且 检 查 
时 不 能 只 看 复制 的 部 分 ， 其 周围 的 部 分 也 要 检查 ， 只 有 这 人 么 做 才能 正确 
地 进行 修改 。 

这 一 过 程 的 成 本 非常 高 。 














对 代码 进行 分 割 管理 


我 们 要 将 代码 分 割 成 多 个 小 块 。 
大 块 代码 之 间 一 般 会 存在 重复 的 部 分 。 将 大 块 代码 分 割 成 多 个 小 块 
之 后 ， 就 能 轻松 找 出 共同 的 部 分 了 。 
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将 代码 分 割 成 多 个 小 块 后 ， 要 明确 代码 内 哪些 地 方 是 完全 一 样 的 ， 
哪些 地 方 是 相似 的 ， 哪 些 地 方 是 完全 不 同 的 。 只 要 区 分 清楚 这 些 ， 代 码 
的 可 读 性 就 会 提高 ， 修 改 成 本 也 会 下 降 。 
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实现 编程 理论 的 六 个 原则 @) 


< 


莫 语 Logic and Data together 


2 出 将 数据 与 逻辑 放 在 相近 的 位 置 


逻辑 与 数据 的 一 体 化 是 指 把 逻辑 和 该 逻辑 处 理 的 数据 放 在 相近 的 位 置 。 
































逻辑 与 数据 的 一 体 化 





所 谓 相近 的 位 置 ， 指 的 是 在 同一 函数 或 同一 模块 内 。 距 离 越 近 ， 代 


码 的 质量 





量 就 越 高 


AAA 汪 数据 与 远 辑 往往 需要 同时 修改 


修改 代码 时 往往 需要 同时 修改 逻辑 与 该 逻辑 处 理 的 数据 。 


因此 ， 如 果 把 二 者 放 在 同一 位 置 ， 我 们 要 阅读 的 代码 就 会 


改 也 不 会 波及 其 他 元 素 。 从 结果 来 看 ， 这 么 做 降低 了 修改 成 本 。 














过 呈 将 数据 与 逻辑 放 在 相近 的 位 置 


我 们 要 把 数据 与 逻辑 放 在 相近 的 位 置 。 
不 过 ,我们 很 难 一 开始 就 知道 哪个 逻辑 应 该 和 哪些 数据 放 在 一 起 。 
这 时 不 妨 先 大 致 安排 一 下 ， 之 后 再 根据 具体 情况 进行 调整 。 


编写 、 运 行 代 码 之 后 ， 数 据 与 逻辑 的 关联 怕 
代码 靠近 数据 ， 



































程 中 逐渐 了 解 具 体 的 做 法 。 
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减少 ， 修 


FE 会 渐渐 显露 出 来 。 是 让 
还 是 让 数据 笔 近 代码 ; 是 将 代码 和 数据 取出 来 放 到 其 他 
位 置 ， 还 是 不 进行 任何 变动 …… 对 于 这 些 问题 ， 我 们 会 在 不 断 尝 


试 的 过 


实现 编程 理论 的 六 个 原则 由 


对 称 性 


英 语 Symmetry 





bl 让 代码 具有 一 贯 性 








对 称 性 一 般 指 事 物 中 对 某 种 变换 保持 不 变 的 性 质 。 以 图 形 中 的 对 称 
性 来 说 ,“ 轴 对 称 ” 就 是 “镜面 对 称 ",“ 点 对 称 ” 就 是 “旋转 对 称 "， 这 
些 都 不 难 理解 。 

而 编程 中 的 对 称 性 要 比 图 形 中 的 对 称 性 抽象 得 多 。 编 程 中 的 对 称 性 
是 指 相同 的 思路 在 代码 的 任何 地 方 都 以 相同 的 形式 表现 出 来 。 

简单 来 说 ， 就 是 组 内 的 等 级 整理 。 同 类 的 东西 ， 也 就 是 拥有 相同 性 
质 的 东西 ， 要 使 用 相同 的 等 级 来 表现 。 


















































MRE 出 可 以 类 推 其 他 部 分 





在 代码 中 明确 表现 出 对 称 性 后 ， 代 码 的 可 读 性 将 大 幅 提高 。 

对 读 代码 的 人 而 言 ， 具 有 对 称 性 的 代码 要 比 参 差 不 齐 的 代码 更 容易 
理解 ， 读 代码 的 人 还 可 以 通过 阅读 部 分 代码 来 类 推 其 他 部 分 。 

对 称 性 存在 于 自然 界 、 数 学 和 艺术 等 方方面面 ， 给 我 们 带 来 美丽 、 
舒适 的 视觉 感受 。 对 称 性 虽然 只 是 一 种 视觉 感受 ， 但 它 对 代码 的 可 读 性 
有 着 巨 大 的 贡献 。 

另外， 追求 对 称 性 从 本 质 上 来 说 属于 消除 重复 代码 的 准备 工作 。 妆 
代码 中 存在 多 个 相似 的 部 分 时 ， 如 果 对 其 进行 对 称 化 处 理 ， 相 同 的 思路 
就 会 以 相同 的 形式 表现 出 来 。 此 后 只 要 将 完全 相同 的 部 分 整合 到 一 起 ， 
就 可 以 消除 代码 中 重复 的 内 容 了 。 
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2 


过 5 恒 相同 的 东西 用 相同 的 形式 表现 

















在 编写 代码 的 时 候 ， 同 类 的 东西 要 用 相同 的 形式 表现 。 














具体 如 下 





@ 如 果 有 “添加 ”方法 ， 就 创建 与 之 相对 的 “删除 ”方法 
@ 同 组 的 函数 用 相同 的 参数 

@ 让 同一 个 模块 里 的 数据 拥有 相同 的 生存 周期 

函数 内 所 有 调用 函数 的 抽象 级 别 要 相同 





实现 编程 理论 的 六 个 原则 @ 
二 时 -站 主 、 
声明 式 表达 


英 语 Declarative Expression 


声明 式 编程 


声明 式 表达 是 指 在 表达 代码 意图 时 ， 尽 量 用 “声明 式 ” 的 表达 方 
式 ， 而 非 “ 命 令 式 ”的 表达 方式 。 








命令 式 编程 描述 的 是 问题 的 解决 方法 ， 也 就 是 数据 结构 与 算法 。 而 
声明 式 编程 描述 的 是 问题 的 定义 ， 也 就 是 当前 问题 的 性 质 及 解决 问题 时 
应 满足 的 限制 条 件 。 








没有 流程 方面 的 限制 ， 可 读 性 更 高 


声明 式 的 代码 没有 流程 方面 的 限制 。 这 种 单纯 阐述 事实 的 表达 方式 


CC 


全 
月 























够 提升 代码 的 可 读 性 。 








另 一 方面 ,我们 要 想 正确 理解 命令 式 的 代码 ， 就 必须 时 常 在 脑 中 摘 


绘 其 状态 、 控 制 及 数据 流 。 为 此 ， 我 们 必须 跟着 代码 的 流程 走向 来 进行 


阅读 。 


采用 声明 式 的 表达 方式 


我 1 


] 要 采用 声明 式 的 表达 方式 ， 简 洁 地 表达 意图 。 




















当 编 程 范 式 使 用 了 声明 式 语言 时 ， 由 于 编写 出 的 代码 是 声明 式 的 ， 


所 以 不 月 




















我 们 去 特别 注意 什么 。 比 如 函数 式 语言 就 是 声明 式 通 月 


编程 语 
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言 中 的 一 个 典型 代表 。 另 外 ，HTML 、CSS 和 SQL 等 非 通用 语言 也 都 是 
声明 式 的 。 

另 一 方面 ， 当 编程 范式 使 用 了 命令 式 语 言 时 ， 我 们 也 要 在 代码 中 合 
适 的 部 分 使 用 声明 式 表 达 ， 以 获取 声明 式 带 来 的 优势 。 代 表 方 法 有 注释 
和 DSL ( Domain Specific Language， 领 域 特定 语言 )。 
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英 语 Rate of 





实现 编程 理论 的 六 个 原则 (@ 


Change 


32 午 | 按 修改 理由 进行 分 组 


变动 率 体现 了 修改 代码 的 时 间 点 ， 变 动 率 相同 意味 着 代码 在 同一 时 


间 点 被 修改 。 
同时 修改 的 元 素 要 放 在 同一 个 地 方 ， 
在 不 同 的 地 方 。 








在 不 同时 间 点 修改 的 元 素 要 放 








这 可 以 说 是 对 时 间 应 用 了 对 称 性 原则 。 同 样 的 东西 要 同等 对 待 ， 这 
一 点 对 修改 代码 的 时 间 来 说 也 一 样 。 同 一 时 间 修 改 的 东西 要 放 在 同一 个 





地 方 。 


BE 出 能 缩小 修改 范围 


在 模块 等 按照 某 种 单位 分 组 的 代码 























中 ， 有 多 个 修改 理由 的 代码 比 





较 脆弱 ， 因 为 一 个 模块 中 如 果 修改 代码 的 时 间 不 同步 ， 那 么 修改 带 来 的 


影响 将 会 波及 无 关 的 部 分 。 修 改 理由 越 


多 ,修改 的 机 会 就 越 多 。 这 种 


代码 一 般 会 承担 多 项 职责 ， 所 以 代码 量 较 大 。 经 过 修改 之 后 ， 代 码 量 会 





[Es 





从 险 。 


强 


相反 ， 如 果 模 块 只 存在 一 个 修改 理由 ， 就 代表 该 模块 由 关联 性 极 强 


一 步 增加 。 久 而 和 久之， 这 类 代码 就 会 像 建 在 沙 地 上 的 楼 阁 一 般 ， 摇 揪 











的 代码 集合 而 成 。 这 类 模块 满足 高 聚合 性 ， 非 常 牢 固 。 因 为 修改 范围 较 
小 ， 影 响 范 围 也 小 ， 所 以 模块 修改 起 来 比较 轻松 。 
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li 时 根据 修改 理由 分 配 位 置 





修改 时 间 相 同 的 元 素 要 放 在 同一 个 地 方 ， 修 改 时 间 不 同 的 元 素 要 放 
在 不 同 的 地 方 。 这 对 逻辑 和 数据 来 说 都 适用 。 

先 看 逻辑 。 举 个 例子 ， 如 果 税 额 计算 包括 “一 般 计算 逻辑 ”和 “各 
年 固有 逮 辑 ”两 种 ， 这 两 种 逻辑 就 要 分 别 放 在 不 同 的 地 方 ， 因 为 二 者 的 
修改 时 间 明 显 不 同 。 这 样 一 来 ， 每 年 在 修改 “各 年 固有 忱 辑 ” 时 ， 就 能 
保证 “一 般 计算 逻辑 ”不 受 影 响 。 

再 看 一 下 数据 。 比 如 模块 中 的 一 部 分 数据 只 在 执行 某 个 特定 函数 
时 才 使 用 ， 这 时 就 要 将 这 部 分 数据 移 至 函数 中 ， 把 它们 用 作 本 地 变量 。 

另外 ， 即 使 某 个 模块 中 存在 一 些 同时 被 修改 的 数据 ， 如 果 这 些 数据 
不 存在 与 其 他 变量 同步 修改 的 必然 性 ， 我 们 也 要 把 这 些 数据 移 至 别 的 
(辅助 ) 模块 中 。 假 设 有 一 个 用 于 对 金融 商品 进行 计算 的 “金融 商品 ” 
模块 ， 该 模块 中 有 “通货 ”和 “金额 ”两 组 数据 。 我 们 新 建 一 个 “ 货 
币 ” 模 块 ， 将 “通货 ”和 “金额 ”的 数据 移动 过 去 。 这 样 一 来 ， 汇 率 换 
算 和 添加 通货 种 类 等 处 理 都 可 以 被 “货币 ”模块 吸收 ,“ 金 融 商 品 ” 模 
块 就 能 专注 于 金融 商品 的 计算 了 。 

































































:有明 单一 职责 原则 


“单一 职责 原则 ”( the Single Responsibility Principle，SRP ) 规定 一 
个 模块 只 能 有 一 个 修改 理由 。 

有 多 个 修改 理由 就 意味 着 模块 承担 了 多 项 职责 。 我 们 不 可 以 创建 这 
样 的 模块 。 

之 所 以 这 么 说 ， 是 因为 承担 多 项 职责 的 模块 十 分 脆弱 。 当 一 个 模块 
承担 了 多 项 职责 时 ， 只 要 其 中 一 项 职责 被 修改 ， 其 他 不 相关 的 地 方 就 会 
受到 影响 ， 模 块 很 可 能 在 不 经 意 间 遭 到 破坏 。 在 维护 过 程 中 ， 如 果 负 责 
修改 的 程序 员 不 是 当初 编写 代码 的 人 ， 那 么 这 个 人 在 修改 代码 的 时 候 很 
可 能 注意 不 到 模块 承担 了 多 项 职责 。 这 样 一 来 ,模块 遭 到 破坏 的 风险 就 
会 进一步 加 大 。 
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模块 的 某 个 部 分 有 多 个 修改 理由 就 证 明 该 模块 违反 了 单一 职责 原 
则 。 一 个 模块 只 承担 一 项 职责 ， 模 块 必须 专注 于 某 项 职责 。 

变动 率 原 则 可 以 帮助 我 们 实现 这 种 状态 。 将 变动 率 相同 的 代码 放 在 
一 起 ， 自 然而 然 就 能 形成 满足 单一 职责 原则 的 模块 。 
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汪 独 隧 贪 优质 代码 的 基本 原理 





软件 架构 基本 技法 共有 以 下 10 种 。 


抽象 

封装 

信息 隐藏 

打包 

关注 点 分 离 

充足 性 、 完 整 性 、 原 始 性 
策略 和 实现 的 分 离 
接口 与 实现 的 分 离 
单一 引用 点 


分 治 


AAA 优质 代码 都 有 “型 ” 


开发 优质 的 软件 需要 有 基本 技法 作为 支撑 。 
这 些 基 本 技法 就 好 比 空手 道中 的 “型 "。 这 些 








历史 中 无 数 程序 员 积 累 而 来 的 实践 经 验 。 








“天 由 


软件 架构 基本 技法 


英 语 EnablingTechniques for Architecture 


源 于 软件 开发 


程序 员 认 识 到 ， 对 于 一 个 问题 ， 特 定 的 解决 方案 要 优 于 其 他 方案 ， 
于 是 这 些 解 决 方案 被 重复 使 用 。 这 些 方案 就 是 基本 技法 。 


我 们 要 把 基本 技法 应 用 到 代码 之 中 。 

基本 技法 不 是 从 某 种 软件 开发 技术 中 总 结 出 来 的 。 这 些 技法 是 更 为 
本 质 的 东西 ， 它 们 适用 于 一 切 开发 方法 以 及 编程 语言 。 

笔者 会 在 接 下 来 的 几 节 对 各 个 基本 技法 进行 详细 说 明 。 
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软件 架构 基本 技法 全 


抽象 


< 


莫 语 Abstraction 





过 此 A 在 概念 上 “ 划 清 界限 ” 

















抽象 ， 是 指 在 概念 上 明确 划 清 界限 。 这 种 明确 划 清 界限 的 方式 可 以 
将 一 个 模块 与 其 他 模块 区 分 开 来 。 

抽象 由 “ 舍 象 ”和 “一 般 化 ”这 两 个 观点 组 合 而 成 。 

舍 象 指 的 是 舍 去 复杂 对 象 的 儿 个 性 质 ， 只 关注 其 特定 的 性 质 。 




















角色 体重 


一 般 化 指 的 是 从 具体 对 象 中 抽出 共同 的 性 质 ， 将 其 固定 为 更 加 通用 
的 概念 。 
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ULEA 汪 抽象 是 对 抗 复 杂 的 手段 








抽象 是 人 们 在 处 理 复杂 事物 时 使 用 的 基本 手段 。 

舍 象 可 以 除去 对 象 的 枝叶 ， 让 它 的 本 质 暴 露出 来 。 复 杂 度 下 降 之 
后 ， 我 们 便 能 集中 精力 去 对 付 真 正 的 问题 。 抽 象 化 的 概念 简明 扼要 ， 便 
于 使 用 ， 应 用 范围 极 广 。 

一 般 化 通过 抽取 共同 特征 将 多 个 对 象 聚 成 一 组 ， 将 它们 视 为 相同 的 
事物 。 如 此 一 来 ， 从 一 个 事物 中 学 到 的 东西 就 可 以 应 用 到 其 他 事物 中 ， 
也 就 是 所 谓 的 闻 一 知 十 。 
编程 虽然 没有 特效 药 和 万 能 药 ， 但 在 解决 问题 方面 ， 抽 象 化 思维 
是 一 个 有 力 的 武器 ， 能 帮 有 我们 引导 出 更 好 的 、 更 有 效率 的 解决 方案 。 


















































二 使 用 “ 舍 象 ”和 “一 般 化 ” 


我 们 要 对 事物 进行 抽象 化 处 理 。 

抽象 化 是 程序 员 实 现 优秀 设计 的 基本 技术 。 

在 处 理 复杂 事物 时 要 进行 舍 象 。 伟 弃 多 余 的 东西 ， 抓 住 本 质 。 需 要 
注意 的 是 ,事物 的 本 质 固然 重要 ,但 在 处 理 问 题 时 ， 我 们 更 应 该 关注 当 
前 问题 的 本 质 。 

在 处 理 多 个 不 同 的 事物 时 要 采用 一 般 化 的 手段 。 抽 取 对 象 共同 的 性 
质 ， 将 这 些 共同 点 组 合成 通用 的 概念 。 本 书 所 说 的 原则 就 是 一 个 典型 的 
例子 。 一 般 化 是 一 种 用 于 在 多 个 事物 之 间 总 结 原则 的 技术 ， 是 一 种 模式 
识别 。 我 们 可 以 从 身边 的 事物 中 找 出 模式 ， 为 其 命名 ， 将 其 作为 原则 应 
用 到 其 他 场合 中 。 

另外 ， 抽 象 的 反面 是 具体 。 具 体 的 事物 便于 理解 ， 但 一 个 一 个 分 析 
具体 级 别 不 同 的 事物 会 消耗 无 尽 的 时 间 ， 况 且 这 种 具体 事物 的 分 析 结 果 
并 不 能 应 用 到 其 他 事物 中 。 

只 有 经 过 抽象 化 处 理 ， 大 量 的 对 象 才 能 套用 统一 的 公式 ， 因 此 在 思 
考 的 效率 上 ， 抽 象 远 胜 于 具体 。 
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软件 架构 基本 技法 加 
封装 


英 语 Encapsulation 





给 数据 和 逻辑 分 组 





将 相互 关联 的 数据 和 逻辑 分 到 一 组 ， 定 义 为 一 个 模块 。 用 模块 这 层 
外 衣 将 关联 性 较 强 的 数据 群 和 逻辑 群 包 右 起 来 的 做 法 称 为 封装 。 
各 个 模块 会 作为 完全 不 相关 的 东西 分 开 进 行 处 理 。 











-Ht 




















ziEA 不 混淆 抽象 概念 


通过 分 组 ， 相 互 关联 的 元 素 被 集中 到 一 个 模块 中 ， 共 同 担负 起 一 个 
抽象 概念 。 这 种 做 法 有 以 下 优点 。 


@ 模块 中 不 存在 不 相关 的 元 素 ， 代 码 可 读 性 提高 

@ 修改 带 来 的 影响 被 限制 在 模块 内 

@ 影响 程度 明确 ， 代 码 更 易于 修改 

@ 各 个 模块 都 是 独立 的 零件 ， 便 于 重复 使 用 

@ 数据 和 逻辑 分 割 成 了 小 单位 的 模块 ， 便 于 我 们 处 理 复杂 问题 


去 恒 将 相关 元 素 封装 在 一 起 


将 相互 关联 的 数据 和 逻辑 分 到 一 组 ， 整 理 成 一 个 模块 。 

封装 时 仅 添 加 相关 元 素 ， 决 不 能 让 无 关 的 元 素 混入 模块 中 。 有 了 关 
联 性 很 强 的 数据 组 成 的 数据 结构 ， 以 及 关联 性 很 强 的 逻辑 组 成 的 函数 群 
之 后 ， 我 们 便 能 获得 简洁 且 高 质量 的 模块 了 。 
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软件 架构 基本 技法 国 
信息 隐藏 


英 语 Information Hiding 





只 展示 必要 的 信息 


对 使 用 模块 的 用 户 隐 藏 模块 实现 相关 的 信息 。 

模块 内 有 哪些 数据 ， 函 数 是 用 何 种 迎 辑 实现 功能 的 ， 这 些 信息 全 部 对 外 
隐藏 。 我 们 要 让 外 部 无 法 直接 访问 模块 内 的 数据 。 模 块 的 函数 也 尽量 不 公开 。 
用 户 只 能 通过 最 低 限 度 公 开 的 函数 来 操作 模块 。 














整理 关系 以 达到 简洁 


将 用 户 不 必 知 晓 的 内 部 详细 信息 隐藏 起 来 ， 可 以 减少 接口 的 代码 
量 ， 让 信息 交互 变 得 更 人 简洁， 降低 代码 的 复杂 程度 。 

从 用 户 的 角度 来 看 ， 由 于 排除 了 多 余 信 息 的 干扰 ， 模 块 的 使 用 方法 
变 得 简单 ， 模 块 也 变 得 更 加 好 用 了 。 

另外 ,公开 的 部 分 越 少 ， 模 块 内 部 的 修改 就 越 不 容易 影响 到 外 部 。 
这 样 可 以 将 修改 代码 的 影响 范围 控制 到 最 小 。 


隐藏 内 部 信息 


仅 公开 模块 简单 的 功能 ， 内 部 状态 和 内 部 功能 全 部 隐藏 。 禁 止 外 部 
访问 模块 内 部 的 数据 以 及 仅 供 模块 内 部 使 用 的 函数 。 

实现 信息 隐藏 需要 使 用 封装 的 手段 。 分 组 可 以 整理 “关系 网 ， 降 
低 隐 藏 信息 的 难度 。 
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封装 与 信息 隐藏 的 区 别 








装 与 信息 两 个 不 同 的 概念 。 我 们 再 来 看 一 下 二 者 的 定义 。 
e@ 封装 
将 相关 元 素 集中 起 来 模块 化 。 


将 关系 紧密 的 数据 与 函数 整合 在 一 起 。 


e 信息 隐藏 
隐藏 模块 的 内 部 状态 和 内 部 函数 。 
阻止 外 部 对 内 部 的 直接 访问 。 





不 过 ， 很 多 技术 文档 将 信息 隐藏 归 到 了 封装 中 ， 可 能 是 因为 “ 封 
装 ” 二 字 给 人 一 种 密封 、 隐 藏 的 感觉 吧 。 

这 种 被 扩充 了 语义 的 “封装 ”一 词 被 广泛 使 用 ， 所 以 大 家 在 遇 到 这 
个 词语 时 ， 要 仔细 阅读 前 后 文 ， 注 意 其 真正 的 含义 。 


;5 二星 Parnas 原则 


Parnas 原则 是 面向 对 象 编程 中 使 用 的 原则 。 以 下 两 个 条 件 定义 了 该 
原则 。 























@ 对 于 模块 的 使 用 者 ， 仅 提供 使 用 该 模块 所 必需 的 所 有 信息 ， 其 余 
信息 一 概 不 予 提供 

@ 对 于 模块 的 开发 者 ， 仅 提供 实现 该 模块 所 必需 的 所 有 信息 ， 其 余 
信息 一 概 不 子 提供 





模块 之 间 的 关系 越 简单 越 好 。 这 样 我 们 就 能 获得 两 个 优势 : 一 是 即 
使 不 知道 模块 的 内 部 信息 ， 也 可 以 使 用 模块 (重复 利用 ); 二 是 可 以 轻 
松 替换 模块 的 内 部 实现 ， 而 不 必 担 心 对 使 用 者 造成 影响 ( 维护 )。 
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软件 架构 基本 技法 由 


打包 


英 语 Packaging 





给 模块 分 组 


将 模块 按照 某 种 有 意义 的 单位 整理 并 分 组 ， 其 实 就 是 将 整个 软件 按 
照 某 种 有 意义 的 单位 进行 分 割 。 这 种 分 割 后 的 产物 称 为 “ 包 ”。 

包 决 定 了 以 何 种 方法 将 软件 的 理论 结构 存储 为 物理 结构 。 包 起 到 
的 是 物理 容器 的 作用 ， 主 要 用 来 以 某 种 有 意义 的 单位 存放 软件 的 功能 。 

















LUEA 汪 降低 模块 群 的 复杂 度 


将 代码 中 的 相关 元 素 封装 成 模块 ， 可 以 起 到 整理 代码 、 降 低 复 杂 度 
的 作用 。 然 而 ， 当 软件 规模 大 到 一 定 程度 之 后 ， 模 块 的 数量 也 会 变 得 非 
常 多 ， 这 同样 会 增加 复杂 度 。 此 时 就 需要 对 模块 群 进 行 分 组 ， 也 就 是 打 
包 。 打 包 有 以 下 优点 。 








@ 整个 软件 被 分 割 成 包 ， 复 杂 度 下 降 
包 内 没有 不 相关 的 模块 ， 便 于 管理 

@ 基本 可 以 把 修改 带 来 的 影响 限制 在 包 内 ， 代 码 的 修改 因此 变 得 更 
加 方便 

@ 依赖 关系 得 到 整理 ， 方 便 代 码 以 包 为 单位 重复 使 用 
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二 自 下 而 上 地 设计 包 


将 相互 关联 的 模块 集中 起 来 打包 。 

我 们 要 等 模块 积攒 到 一 定数 量 之 后 再 自 下 而 上 地 对 包 进 行 设计 。 这 
项 工作 不 可 能 一 开始 就 通过 自 上 而 下 的 方式 来 完成 。 

包 这 种 比较 大 的 分 解 单位 容易 被 误 认 为 是 用 于 功能 分 解 的 单位 ， 但 
包 其 实 是 表现 软件 构建 方法 的 “图 纸 ”。 项 目 最 初 并 没有 可 以 构建 的 软 
件 ， 所 以 不 可 能 实现 自 上 而 下 的 设计 。 

随 着 开发 的 进行 ， 模 块 将 越 来 越 多 。 此 时 我 们 就 可 以 开始 自 下 而 上 
地 设计 包 了 。 包 的 设计 并 不 是 一 锤子 买卖 ， 包 还 要 随 着 编程 的 推进 不 断 
成 长 和 进化 。 
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软件 架构 基本 技法 @ 


英 语 Separation of Concerns 





2 出 根据 关注 点 分 离 代 码 


关注 点 指 软件 的 功能 或 目的 。 把 关注 点 “分 离 ”， 就 是 将 与 各 个 关 
注 点 有 关 的 代码 集中 起 来 做 成 独立 的 模块 ， 与 其 他 代码 分 离 。 分 离 后 
的 模块 要 尽量 减少 公开 的 功能 数量 ， 与 其 他 模块 的 关联 也 要 维持 在 最 低 
限度 。 

在 设计 技法 中 ， 有 很 多 模式 用 于 实现 关注 点 分 离 。 其 中 最 具 代表 性 
的 模式 是 “模型 - 视图 - 控制 器 ”( Model-View-Controller，MVC)。 在 
编程 领域 ,关注 点 分 离 的 代表 技术 是 面向 切面 编程 ( Aspect-Oriented 
Programming, AOP )。 























E22 出 修改 以 关注 点 为 单位 


代码 的 修改 通常 以 关注 点 为 单位 。 因 此 ， 将 代码 按照 关注 点 进行 分 
离 有 以 下 好 处 。 


@ 各 个 关注 点 互相 独立 ， 从 而 缩小 了 代码 的 修改 范围 ， 使 代码 更 易 


于 修改 

@ 修改 带 来 的 影响 限制 在 了 关注 点 之 内 ， 因 此 代码 的 质量 能 够 保持 
稳定 

@ 因为 代码 的 编写 是 以 关注 点 为 单位 进行 的 ， 所 以 能 够 实现 并 行 
开发 


87 


以 关注 点 为 单位 模块 化 





以 关注 点 为 单位 创建 模块 ， 把 不 同 的 功能 、 不 相关 的 功能 分 开 。 比 
如 在 “模型 - 视 岁 - 控制 咒 ” 模 式 下 ， 业 务 逻 辑 、 用 户 显 示 和 输入 处 理 
互相 分 离 。 

另外 ， 如 果 一 个 模块 在 不 同 前 提 下 有 不 同 的 功能 ， 我 们 就 需要 分 割 该 
模块 ， 让 各 个 功能 处 于 独立 的 状态 。 一 般 来 讲 ， 一 个 模块 不 可 以 拥有 多 


个 功能 。 














5 后续 由 面向 切面 编程 











面向 切面 编程 是 一 种 擅长 分 离 “ 横 切 关 注 点 ”的 技术 。 所 谓 横 切 关 
注 点 ， 就 是 指 横 穿 于 各 个 关注 点 之 间 的 关注 点 。 

一 般 情况 下 ， 横 切 关 注 点 会 散布 在 各 个 功能 之 中 。 这 是 妨碍 我 们 修 
改 代 码 的 一 大 因素 。 横 穿 所 有 功能 的 日 志 功 能 就 是 一 个 很 好 的 例 
子 。 日 志 功 能 虽然 由 独立 的 模块 提供 ,但 日 志 的 调用 会 直接 写 在 各 个 功 
能 之 中 。 

除了 日 志 功 能 ， 数 据 库 事务 的 开始 及 结束 处 理 、 防 火 墙 的 访问 控制 
处 理 等 也 具有 横 切 关注 点 的 特征 。 

在 面向 切面 编程 中 ， 这 些 横 切 关注 点 会 根据 某 种 结合 规则 自动 添加 
到 各 关注 点 的 相应 位 置 ， 从 而 避免 被 代码 直接 调用 。 面 向 切面 编程 就 是 
通过 这 种 方式 实现 关注 点 分 离 的 。 
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软件 架构 基本 技法 @ 
充足 性 、 完 整 性 、 原 始 性 


-i 


英 语 Sufficiency, Completeness, Primitiveness 





2 出 表达 要 充足 、 完 备 且 精练 


经 过 封装 ， 我 们 让 相互 关联 的 元 素 集中 到 一 个 模块 来 承载 一 个 抽象 
概念 。 该 模块 承载 的 抽象 概念 要 具有 充足 性 、 完 整 性 和 原始 性 。 








e 充足 性 
充足 性 是 指 模块 表达 的 抽象 概念 非常 充足 。 
比如 模块 要 表达 “收集 ”这 一 概念 ， 但 只 提供 了 remove， 没有 
提供 add， 这 就 不 足以 表达 “收集 ”这 一 概念 了 。 


e 完整 性 
完整 性 是 指 模块 表达 的 抽象 概念 具有 所 有 特征 。 涵 盖 所 有 特征 、 
没有 缺漏 的 模块 方便 任何 人 拿 去 使 用 。 
比如 当 模 块 要 表达 “收集 ”这 一 概念 时 ， 如 果 模 块 没有 提供 用 于 
获取 元 素 个 数 的 size， 我 们 就 不 能 说 该 抽象 概念 具有 完整 性 。 


e 原始 性 
原始 性 是 指 模块 表达 的 抽象 概念 非常 精练 。 
比如 当 模 块 要 表达 “收集 ”这 一 概念 时 ， 如 果 已 经 提供 了 表示 添加 
1 个 物品 的 add， 则 不 需要 再 提供 表示 添加 10 个 物品 的 add10。 
从 抽象 的 精练 性 这 一 角度 来 看 ， 这 么 做 是 多 余 的 。 
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准确 表达 抽象 概念 


模块 表达 的 抽象 概念 必须 能 向 使 用 者 传递 有 用 的 信息 ， 准 确 表达 
意图 。 

如 果 模 块 不 具备 充足 性 ， 信 息 就 会 出 现 缺 失 ， 导 致 用 户 看 不 清 模块 
的 本 质 。 人 们 无 法 把 说 不 清道 不 明 的 模块 拿 来 使 用 。 

不 具备 完整 性 的 模块 无 法 让 用 户 安心 使 用 。 一 旦 出 现 功 能 不 足 的 情 
况 ， 工 作 就 难以 进行 下 去 。 

不 具备 原始 性 的 模块 用 起 来 很 麻烦 。 复 杂 的 接口 提升 了 理解 的 难 
度 ， 让 人 弄 不 清楚 使 用 时 机 和 使 用 方法 。 



































完美 表达 模块 的 抽象 概念 


我 们 要 明确 模块 要 表达 的 抽象 概念 。 

信息 过 多 或 过 少 都 会 使 信息 的 传达 变 得 不 准确 。 因 此 模块 提供 的 函 
数 要 满足 充足 性 、 完 整 性 和 原始 性 。 当 出 现 多 余 的 内 容 时 ， 要 么 将 其 删 
除 ， 要 么 将 其 移 至 其 他 模块 。 
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软件 架构 基本 技法 人 OO 


策略 和 实现 的 分 离 


英 语 Separation of Policy and Implementation 





CA 策略 和 实现 不 同时 存在 


模块 可 以 承载 策略 或 实现 。 但 是 ， 一 个 模块 不 可 以 同时 承载 二 者 。 


e 策略 模块 
策略 模块 依赖 于 软件 的 前 提 条 件 ， 这 类 模块 通常 用 于 给 业务 逻辑 
或 其 他 模块 选择 参数 。 


e 实现 模块 
实现 模块 不 依赖 于 软件 的 前 提 条 件 ， 这 类 模块 通常 是 独立 的 逻辑 
部 分 。 软 件 的 前 提 条 件 会 作为 传递 给 模块 的 参数 给 出 。 


中 


ULA 汪 实现 稳定 但 策略 不 稳定 


实现 模块 不 依赖 于 特定 的 软件 ， 是 一 种 纯粹 的 模块 ， 因 此 可 供 其 他 
软件 重复 使 用 。 

而 策略 模块 是 为 特定 软件 量 身 打造 的 。 当 软件 发 生变 动 时 ， 策 略 模 
块 也 要 被 迫 发 生 改 变 。 因 此 ， 如 果 将 实现 和 策略 混在 一 起 ， 那 么 当 策 
略 发 生变 动 时 ， 实 现 也 会 受到 牵连 ， 影 响 模块 的 重复 使 用 。 
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怎么 做 


将 策略 与 实现 存放 在 不 同 的 模块 中 


设计 时 要 有 意识 地 区 分 依赖 于 软件 前 提 条 件 的 策略 部 分 和 不 依赖 于 


软件 前 提 条 
当 遇 到 
实现 部 分 。 
另外 ， 








件 的 实现 部 分 ， 然 后 将 二 者 分 别 写 和 不同 的 模块 。 
无 法 分 离 的 情况 时 ， 至 少 要 在 模块 内 部 明确 区 分 策略 部 分 和 














即便 最 初 分 离 了 策略 与 实现 ， 在 维护 代码 的 过 程 中 二 者 也 可 














能 会 重新 混在 一 起 。 因 此 在 开展 修改 工作 之 前 ， 要 明确 修改 对 象 到 底 属 





人 
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: 现 ， 至 少 保证 实现 部 分 中 不 会 混入 策略 的 相关 代码 。 


软件 架构 基本 技法 (@) 


接口 与 实现 的 分 离 


英 语 Separation of Interface and Implementation 





污 独 尹 驴 模块 由 接口 和 实现 组 成 
模块 由 接口 和 实现 这 两 个 相互 分 离 的 部 分 组 成 。 


e 接口 部 分 
接口 部 分 用 于 定义 模块 具备 的 功能 ， 决 定 模块 的 使 用 方法 。 该 部 
分 由 用 户 可 访问 的 函数 签名 组 成 。 


ee 
部 分 其 实 就 是 实现 模块 功能 的 代码 部 分 。 该 部 分 包含 模块 内 
we 的 逻辑 和 数据 。 
用 户 无 法 访问 实现 部 分 


edA 汪 使 用 者 只 需 理解 接口 





接口 与 实现 分 离 之 后 ， 模 块 的 使 用 者 〈 用 户 ) 就 不 必 了 解 实现 的 详 
细 内 容 了 。 这 样 一 来 ， 展 现在 用 户 眼前 的 就 只 有 接口 ， 模 块 变 得 简单 易 
懂 ， 可 以 让 用 户 轻 松 使 用 。 

另外 ,接口 与 实现 分 离 能 保证 “模块 的 使 用 方法 ”(= 接口 ) 和 “ 功 
能 的 实现 方法 ”(= 实现 ) 的 独立 性 。 如 此 一 来 ， 修 改 实现 部 分 时 就 不 
必 担 心 会 对 接口 造成 影响 了 。 
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针对 接口 编程 


关于 模块 的 设计 原理 ， 有 一 句 “ 针 对 接口 编程 ， 而 不 是 针对 实现 编 
程 ” 的 格言 。 因 此 ， 模 块 之 间 的 调用 要 保证 只 使 用 接口 来 完成 。 接 口 的 
实现 要 隐藏 在 接口 背后 ， 该 部 分 不 能 被 直接 调用 。 
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软件 架构 基本 技法 (9) 


单一 引用 所 


英 语 Single Point of Reference 





只 定 X- 次 


模块 的 各 元 素 仅 被 声明 和 定义 一 次 。 

以 变量 为 例 ， 仅 定义 一 次 就 是 指 初始 化 之 后 就 不 再 对 值 进行 更 
改 了 。 这 样 一 来 ， 我 们 就 不 用 再 追踪 变量 值 的 变迁 过 程 ， 代 码 的 可 读 性 
也 随 之 提高 。 








5 使 编程 无 副作用 


该 基本 技法 可 以 使 编程 无 副作用 。 

所 谓 编程 的 副作用 ， 是 指 某 一 功能 使 模块 状态 产生 变化 ， 对 此 后 得 
到 的 结果 造成 影响 。 排 除 副 作用 能 免 去 状态 的 变化 ， 保 证 相同 数据 能 始 
终 获得 相同 的 结果 ， 从 而 减少 状态 依赖 引发 的 故障 。 

另外 ， 当 某 一 变量 被 大 范围 使 用 且 该 变量 的 值 被 频繁 更 改 时 ， 我 们 
将 很 难 对 代码 进行 追踪 。 变 量 值 固定 则 可 以 省 去 这 些 麻 烦 ， 从 而 提高 代 
码 的 可 读 性 。 




















la 观音 一 赋值 


所 谓 单一 赋值 ， 是 指 仅 对 变量 执行 一 次 赋值 操作 。 我 们 要 将 副作用 
视 为 “应 该 避免 的 东西 >， 把 变量 看 作 “ 不 变 的 东西 >， 给 变量 赋值 后 就 
不 再 对 其 进行 更 改 。 
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大 多 数 编程 语言 允许 对 变量 重新 赋值 ， 但 是 我 们 要 跳出 语法 的 限 
制 ,通过 使 用 常量 、 设 置 规 则 来 禁止 重新 赋值 等 方式 ,编写 没有 副作用 
的 代码 。 

















通过 控制 变量 提升 代码 质量 





即便 我 们 想 努 力 实现 单一 引用 点 这 一 基本 技法 ,但 在 实际 编程 中 还 
是 要 管理 大 批 变量 ， 这 就 难免 会 发 生 故 障 。 

容易 发 生 故 障 的 都 是 那些 非 必要 的 可 变 变 量 。 如 果 消 除 不 必要 的 可 
变性 ， 增 加 不 可 变 变 量 ， 代 码 的 质量 就 能 得 到 提升 。 

同时 ， 对 于 剩 下 的 〈 必 要 的 ) 可 变 变量 ， 要 尽量 减少 访问 它 的 逻辑 
数量 ,缩小 其 作用 域 。 我 们 要 养 成 写 小 函数 的 习惯 ,限制 各 个 函数 的 职 
能 。 要 保证 各 个 函数 只 作用 于 传递 给 它们 的 参数 。 

如 此 一 来 ， 即 使 我 们 为 变量 赋 了 非法 的 值 ， 也 能 轻松 找 出 问题 所 
在 。 反 过 来 ， 如 果 代 码 不 满足 上 述 条 件 ， 我 们 就 需要 推测 非法 赋值 是 在 
什么 情况 下 发 生 的 ， 这 样 就 会 在 排查 故障 方面 耗费 大 量 时间 。 












































;SEE 明 引用 透明 性 





引用 透明 性 指 函 数 拥 有 以 下 两 种 特性 。 











e 调用 结果 只 依赖 于 参数 
这 个 特性 说 的 是 数学 中 的 函数 。 
给 参数 传递 相同 的 值 总 能 得 到 相同 的 返回 值 ， 也 就 是 说 ， 返 回 值 
只 依赖 于 参数 的 值 。 这 种 特性 称 为 “单纯 性 ”。 


e 调用 不 影响 其 他 功能 的 运行 
这 个 特性 是 说 函数 没有 副作用 。 所 谓 副作用 ， 是 指 “ 某 一 处 理 引 
起 状态 改变 ， 对 此 后 的 处 理 结果 产生 影响 ”。 
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具有 引用 透明 性 的 函数 独立 于 外 部 状态 运行 ， 这 类 函数 会 在 自身 内 
部 完成 所 有 处 理 。 

具有 这 种 特性 的 函数 测试 起 来 非常 简单 。 我 们 只 需 准 备 一 系列 测试 
数据 作为 参数 值 ， 然 后 验证 函数 调用 结果 即 可 。 

引用 透明 性 对 优化 处 理 也 有 一 定好 处 ， 比 如 可 以 用 已 知 的 处 理 结 
代替 函数 调用 等 。 
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软件 架构 基本 技法 加 
分 治 


< 


英 语 Divide and Conquer 





AAA 将 大 问题 分 割 成 小 问题 











分 治 是 指 将 难以 直接 解决 的 大 问题 分 割 成 多 个 小 问题 ， 然 后 逐个 
解决 。 

分 割 后 的 小 问题 要 比 最 初 的 问题 简单 许多 ， 比 较 容 易 解决 。 各 个 小 
问题 被 逐一 解决 之 后 ， 原 来 的 大 问题 就 不 复 存 在 了 。 











zi 大 问题 无 法 控制 


直接 解决 大 问题 的 话 ， 难 度 较 大 ， 论 费 的 时 间 也 比较 多 ， 疗 不 好 到 
最 后 问题 也 解决 不 了 。 之 所 以 会 出 现 这 样 的 现象 ， 是 因为 规模 过 大 的 问 
题 ， 其 复杂 度 也 比较 高 。 

先 将 问题 分 割 成 容易 控制 的 大 小 ， 再 着 手 解决 ， 这 么 做 效率 比 





[Yi 全 将 问题 分 割 后 逐个 击破 











先 对 问题 进行 分 割 ， 然 后 再 一 个 一 个 解决 。 比 如 下 面 几 种 做 法 。 











@ 在 设计 整个 软件 时 ， 先 将 软件 分 割 成 多 个 可 以 独立 设计 的 部 分 ， 
然后 对 这 些 部 分 一 一 进行 设计 
@ 在 设计 模块 时 ， 按 照 职 责 对 模块 进行 分 割 
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@ 在 设计 算法 时 ， 可 以 像 归并 排序 一 样 ， 先 自 下 而 上 地 对 问题 进行 
分 割 ， 再 探讨 能 否 解 决 问题 

@ 在 处 理 海量 数据 时 ， 可 以 像 MapReduce 一 样 ， 先 将 计算 分 割 成 较 
小 的 单位 ， 然 后 探讨 能 否 把 这 些 计算 交 给 分 布 式 环境 并 行 处 理 
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软件 架构 的 非 功能 需求 


英 语 Non-functional requirement for 
Architecture 





“功能 之 外 的 功能 ”的 观点 


非 功能 需求 指 功能 方面 以 外 的 一 切 需 求 。 

要 想 让 软件 具有 高 质量 ， 真 正 服务 于 用 户 ， 单 纯 满 足 功能 需求 是 不 
够 的 ， 还 要 满足 非 功 能 需求 。 在 软件 架构 设计 中 ， 非 功能 需求 与 功能 需 
求 一 样 重要 。 非 功能 需求 包含 以 下 几 种 观点 。 

















@ 匈 交 性 
@ 互 操作 性 
@ 效率 性 
@ 可 靠 性 
@ 可 测试 性 
@ 可 复 用 性 


zi 非 功能 需求 在 软件 发 布 后 具有 很 大 的 影响 力 


非 功能 需求 对 开发 、 运 维 以 及 计算 机 资源 的 高 效 运用 有 着 很 大 的 影 
响 。 男 外 ， 在 发 布 后 的 运 维 阶 段 ， 比 较 大 的 问题 多 是 由 性 能 、 系 统 宕 机 
等 非 功 能 需求 引起 的 。 

然而 与 功能 需求 相 比 ， 这 些 重要 的 非 功 能 需求 往往 被 忽视 、 推 后 。 
其 实 ， 非 功能 需求 应 该 在 开发 最 初 ， 也 就 是 设计 软件 架构 的 时 候 就 纳 
入 考量 。 
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壹 Ai 恒 从 非 功能 需求 的 观点 进行 设计 


在 软件 架构 的 设计 阶段 就 将 非 功 能 需求 纳入 考量 ， 绝 对 不 能 拖 到 后 
面 再 做 。 
具体 做 法 如 下 。 





@ 在 需求 定义 方面 ， 确 认 各 个 观点 的 被 需求 程度 

@ 在 开发 方面 ， 从 软件 架构 的 设计 阶段 开始 就 将 非 功 能 需求 纳入 结 
构 之 中 

@ 在 测试 方面 ， 确 认 需 求 是 否 得 到 满足 


从 3.23 节 开 始 ， 笔 者 将 逐一 讲解 非 功 能 需求 的 各 个 观点 。 


局 ;汪汪 非 功 能 测试 





功能 测试 着 眼 于 “做 什么 ”， 而 非 功能 测试 着 眼 于 “怎样 运作 ”。 二 
者 的 着 眼 点 不 同 。 

非 功能 测试 与 功能 测试 同样 重要 。 软 件 的 目的 不 是 实现 功能 ， 而 是 
让 用 户 达 到 自己 的 目的 。 其 中 ， 非 功能 需求 占 了 很 大 的 比重 。 

要 想 满 足 非 功 能 需求 ， 首 先 要 找 出 适合 当前 软件 的 非 功 能 需求 标准 ， 
然后 给 非 功 能 测试 设置 一 个 合格 线 ， 毕 竞 没 有 目标 就 无 法 满足 需求 。 




















E33 后 后 嘻 别 非 功能 安全 性 需求 





在 非 功能 需求 中 ,“ 安 全 性 ”( security ) 非常 重要 。 

简单 来 说 ,信息 的 安全 性 就 是 指 保护 软件 所 涉及 的 信息 资产 不 被 非 
法 访问 、 泄 露 和 算 改 。 随 着 以 使 用 网 络 为 前 提 的 软件 越 来 越 多 ， 用 户 对 
安全 性 的 要 求 也 变 得 越 来 越 高 。 

言 息 安 全 性 的 定义 是 维持 信息 的 机 密 性 、 完 整 性 和 可 用 性 。 人 们 将 
机 密 性 ( confidentiality )、 完 整 性 ( integrity ) 和 可 用 性 (availability ) 
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称 为 “信息 安全 三 要 素 "。 取 这 三 个 单词 的 首 字 母 ， 信 息 安 全 三 要 素 又 
叫 作 “信息 安全 的 CIA”。 


e 机 密 性 
机 密 性 指 对 未 获 授权 的 个 人 、 实 体 或 进程 不 公开 信息 或 禁止 其 使 
用 信息 。 也 就 是 不 让 未 获得 许可 的 人 或 其 他 对 象 使 用 信息 。 
如 果 第 三 者 能 轻松 访问 重要 信息 ， 就 会 有 信息 泄露 的 风险 。 因 
此 ， 我 们 需要 给 重要 的 信息 添加 访问 控制 ， 也 可 以 给 信息 加 密 ， 
这 样 一 来 ， 即 使 信息 泄露 ， 其 他 人 也 无 法 阅读 信息 内 容 。 


如 果 第 三 者 擅自 改写 、 删 测 汪 二 表册 本 息 ， 这 些 信息 就 会 失去 使 用 
价值 。 不 仅 如 此 ， 一 旦 使 用 者 没有 发 现 信息 半 到 自 改 ， 问 题 的 严 
重 性 就 可 能 会 进一步 加 大 。 

因此 ， 人 们 通常 使 用 数字 签名 等 技术 来 确保 完整 性 。 


可 用 性 

可 用 性 指 当 获得 授权 的 实体 发 来 请 求 时 ， 允 许 实体 访问 和 使 用 信 
息 。 也 就 是 说 ， 实 体 可 以 随时 访问 和 使 用 信息 。 对 组 织 而 言 ， 能 
够 随时 访问 自己 所 持 有 的 重要 信息 这 一 点 非常 重要 。 

因 系 统 故障 而 无 法 访问 信息 ， 或 者 计算 机 病毒 导致 系统 无 法 使 用 
等 ， 都 属于 重大 问题 。 

因此 ， 我 们 需要 通过 对 系统 和 信息 进行 备份 、 设 置 防火 墙 抵御 病 
毒 等 手段 来 防范 问题 发 生 。 








ES; 冯 甩 IEE 检验 安全 性 


在 检验 安全 性 的 时 候 ， 首 先 要 进行 “渗透 测试 ”( penetration test )。 














渗透 测试 是 一 种 为 寻找 安全 漏洞 而 对 软件 进行 攻击 并 尝试 入侵 的 检验 
方法 。 
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不 过 ， 这 种 检验 方法 需要 一 些 高 级 知识 和 高 超 的 技术 水 平 作为 文 
撑 。 在 检验 时 ， 借 助 漏洞 攻击 工具 ， 可 以 减少 检验 项 目的 遗漏 。 另 外 ， 
外 包 给 专门 的 组 织 ， 由 外 部 来 进行 安全 性 诊断 也 是 一 个 不 错 的 方法 。 这 
种 做 法 虽然 会 提高 成 本 ， 但 可 以 得 到 专家 的 验证 ， 能 让 用 户 更 放心 地 使 
j 软 件 。 

此 外 ,在 检验 安全 性 时 ， 我 们 还 要 考察 发 生 安全 事故 时 软件 的 追踪 
能 力 和 监察 能 力 。 从 这 一 角度 出 发 ， 访 问 日 志 的 内 容 、 保 存 时 间 等 也 需 
要 检验 。 

在 思考 安全 性 的 相关 对 策 时 还 要 注意 一 点 ， 那 就 是 软件 的 易 用 性 。 
如 果 软 件 的 用 户 认证 需要 极 长 的 密码 ， 或 者 用 户 需要 进行 大 量 的 操作 才 
能 获取 信息 ， 用 户 理解 和 操作 软件 的 难度 就 会 加 大 。 所 以 ,我 们 在 检验 
安全 性 需求 的 同时 也 要 把 握 其 与 易 用 性 之 间 的 平衡 。 
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软件 架构 的 非 功 能 需求 
易 变 性 


英 语 Changeability 





轻松 修改 软件 的 能 


易 变 性 指 软件 能 被 轻松 改良 的 能 力 。 

具体 来 讲 ， 易 变性 要 求 软件 能 被 轻易 修改 、 轻 易 扩 展 、 轻 易 重组 、 
轻易 移植 到 其 他 平台 。 此 外 ， 在 保证 质量 的 前 提 下 迅速 完成 改良 也 是 易 
变性 的 要 求 之 一 。 
































2 有 和 软件 的 寿命 比 预想 的 长 


我 们 总 希望 软件 在 发 布 之 后 一 直 不 用 修改 ,但 事实 并 非 如 此 。 软 件 
在 使 用 周期 内 会 不 断 被 修改 和 扩展 。 原 需求 会 不 断 发 生变 更 ， 新 需求 也 
会 不 断 添加 进来 。 

特别 是 业务 领域 中 使 用 的 大 规模 软件 ， 这 类 软件 通常 有 着 很 长 的 寿 
命 ， 某 些 软件 甚至 能 存活 几 十 年 。 

要 想 长 期 快速 应 对 用 户 的 各 种 琐碎 要 求 ， 我 们 就 需要 设计 出 便于 修 
改 代码 的 软件 架构 。 











[a 对 可 维护 性 、 可 扩展 性 、 重 组 和 可 移植 性 


软件 架构 的 设计 要 从 可 维护 性 、 可 扩展 性 、 重 组 和 可 移植 性 这 四 个 
方面 进行 考察 。 
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e 可 维护 性 

可 维护 性 指 解 决 问题 的 难 易 度 ， 即 修改 故障 代码 的 难 易 度 。 

要 提高 可 维护 性 ， 使 用 的 软件 架构 就 必须 能 将 修改 控制 在 局 部 范 
围 内 ， 把 对 其 他 模块 的 副作用 降 至 最 低 。 


e 可 扩展 性 
可 扩展 性 指 添加 新 功能 、 更 新 模块 版 本 以 及 删除 不 需要 的 功能 和 
模块 等 操作 的 难 易 度 。 
提高 可 扩展 性 需要 降低 模块 之 间 的 结合 度 。 
可 扩展 性 追求 的 是 能 在 不 给 客户 端 造 成 影响 的 情况 下 完成 模块 交 
换 的 结构 ， 以 及 能 将 新 模块 整合 到 现 有 软件 架构 中 的 结构 。 


注 


e 重组 
重组 指 重 新 组 织 模块 间 的 关系 。 当 对 模块 的 位 置 进 行 调整 时 (上 比 
如 将 模块 移 至 其 他 子 系统 )， 就 需要 进行 重组 。 
为 方便 重组 ， 我 们 设计 的 软件 架构 要 能 在 不 影响 模块 实现 的 前 提 
下 灵活 对 模块 进行 配置 。 


e 可 移植 性 

可 移植 性 指 将 软件 移植 至 各 种 硬件 平台 、 用 户 接口 、 操 作 系 统 、 
编程 语言 和 编译 器 等 的 难 易 度 。 

要 提高 可 移植 性 ， 就 要 在 设计 软件 时 考虑 软件 对 硬件 的 依赖 性 。 
要 想 做 出 不 依赖 于 硬件 的 软件 ， 就 要 将 系统 库 和 用 户 接口 库 等 对 
平台 特有 功能 进行 操作 的 部 分 整合 成 一 个 独立 的 专用 模块 。 


局 ES 灵活 性 的 取舍 


设计 优质 软件 架构 的 关键 点 在 于 ， 要 清楚 软件 的 哪些 部 分 需要 具备 
较 高 的 灵活 性 以 应 对 修改 ， 哪 些 部 分 不 会 被 修改 。 

在 此 基础 上 ， 对 需要 具备 较 高 灵活 性 的 部 分 套用 支持 修改 的 设计 模 
式 ， 提 高 灵活 性 。 
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不 过 ， 这 种 支持 修改 的 设计 有 一 点 需要 我 们 注意 。 在 选择 高 灵活 性 
的 软件 构架 时 ， 人 们 人 往往 把 灵活 性 设计 得 过 高 。 这 样 一 来 ， 模 块 就 会 失 
去 简洁 性 ， 导 致 软件 的 可 扩展 性 下 降 。 

因此 ， 灵 活性 不 是 越 高 越 好 。 我 们 要 考虑 灵活 性 与 简洁 性 之 间 的 
平衡 。 























局 sa 软件 老化 


就 像 人 会 变 老 一 样 ， 软 件 也 会 变 老 ， 这 就 是 “软件 老化 ”的 观点 。 
软件 老化 是 指 软件 随 着 时 间 的 流逝 慢 慢 退化 。 软 件 老 化 的 原因 有 以 
下 几 点 。 





@ 设计 灵活 性 不 足 ， 代 码 的 修改 使 软件 架构 遭 到 破坏 

@ 设计 本 身 没 有 问题 ， 但 负责 修改 的 人 没有 理解 设计 ， 于 是 软件 架 
构 遭 到 破坏 

软件 架构 难以 让 人 理解 ， 最 终 被 混乱 的 修改 所 破坏 

更 新 停滞 ， 被 时 代 抛 齐 ， 软 件 越 来 越 陈旧 





我 们 无 法 阻止 软件 老化 ， 但 是 我 们 能 够 减缓 软件 的 老化 速度 。 通 过 
了 解 软件 老化 的 原因 ， 按 照 一 定 步 又 抑制 老化 进程 ， 及 时 弥补 损伤 ， 相 
信 我 们 能 看 到 软件 完成 使 命 寿终正寝 的 那 一 天 。 

我 们 可 以 采用 很 多 手段 来 防止 软件 老化 ， 比 如 准确 进行 文档 化 、 修 
改 时 注意 保护 软件 架构 、 认 真 审查 、 采 用 具有 灵活 性 的 设计 准确 预测 修 
改 位 置 等 。 
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软件 架构 的 非 功 能 需求 @ 
互 操 作 性 


英 语 Interoperability 





有 2 出 与 其 他 软件 交互 的 能 


互 操 作 性 指 软件 与 其 他 软件 交互 的 能 力 。 互 操作 性 要 求 不 同 的 软件 
之 间 使 用 同一 交换 方式 来 交换 数据 、 读 取 相 同 格式 的 文件 、 使 用 相同 的 
协议 等 ， 从 而 实现 相互 连接 的 状态 。 





LEA 软件 间 协 作 





软件 并 不 是 独立 存在 的 ， 它 是 系统 的 一 部 分 ， 会 频繁 地 与 其 他 系统 
或 环境 发 生 作用 。 

能 与 其 他 软件 协作 ， 就 意味 着 我 们 可 以 直接 使 用 既 有 资产 。 这 样 一 
来 , 需要 我 们 开发 的 软件 就 会 减少 。 

良好 的 连接 性 能 扩大 软件 的 用 途 ， 缩 短 开发 周期 ， 减 少 成 本 。 


选择 标准 规格 


在 设计 软件 架构 时 ， 要 明确 定义 需要 访问 的 外 部 功能 以 及 数据 结 
构 。 这 么 做 能 够 提升 软件 的 价值 。 

另外 ,在 选择 协议 和 数据 格式 时 ， 要 选择 业界 标准 规格 。 从 长 远 来 
看 ， 选 用 标准 规格 能 长 期 保持 软件 的 价值 。 
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不 过 ， 在 实际 开发 中 ， 很 多 时 候 开 发 的 软件 要 迎合 一 些 既 有 软件 ， 
保证 与 这 些 软件 的 互 操作 性 。 这 时 ， 我 们 要 仔细 确认 连接 方式 以 满足 既 
有 软件 的 连接 要 求 。 在 两 个 既 有 软件 相互 连接 的 情况 下 ， 可 以 考虑 导入 
其 他 软件 作为 介质 。 
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软件 架构 的 非 功能 需求 @) 


英 语 Efficiency 





高 效 使 用 资源 的 能 


效率 性 指 软件 在 运行 过 程 中 使 用 资源 发 挥 性 能 的 能 力 。 
效率 性 大 致 分 为 以 下 两 种 。 








e 时 间 效 率 性 

时 间 效 率 性 从 时 间 的 角度 来 定义 资源 的 使 用 效率 。 

时 间 效 率 性 可 以 通过 一 定时 间 内 可 以 完成 的 处 理 数量 ( 通 量 入 
从 用 户 执 行 输入 操作 到 应 答 所 花费 的 时 间 ( 响应 时 间 )、 从 用 户 
开始 操作 到 输出 所 需 信息 所 花费 的 时 间 ( 周转 时 间 ) 等 来 衡量 。 


e 资源 效率 性 

资源 效率 性 从 计算 机 资源 的 角度 来 定义 资源 的 使 用 效率 。 

资源 效率 性 可 以 通过 CPU 占用 时 间 、 内 存 使 用 量 、 存 储 空间 占 
用 量 和 网 络 传输 量 等 来 衡量 。 


资源 是 有 限 的 


资源 是 有 限 的 ， 所 以 软件 需要 高 效 地 使 用 资源 。 资 源 使 用 方法 不 当 
会 使 软件 的 运行 变 得 缓慢 ， 导 致 用 户 体验 变 差 。 

不 过 ， 效 率 问题 并 不 是 使 用 成 体系 的 算法 就 能 解决 的 。 要 想 提高 效 
率 ， 就 要 在 软件 架构 的 设计 阶段 将 职责 分 散 到 各 个 模块 ， 并 将 各 个 模块 
适当 关联 起 来 。 
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条 用 次 


我 们 要 合理 使 用 计算 机 的 资源 。 

所 谓 合理 使 用 ， 当 然 不 是 说 用 得 越 少 越 好 ， 而 是 指 有 效 利用 既 有 资 
源 来 最 大 限度 地 发 挥 软件 性 能 。 节 约 是 必须 的 ， 但 我 们 在 设计 软件 架构 
时 也 要 将 资源 的 灵活 使 用 纳入 考虑 的 范围 。 











间接 化 与 效率 性 的 平衡 


为 了 避免 各 个 模块 直接 关联 ， 我 们 有 时 会 在 模块 之 间 导 入 “媒介 模 
块 "。 这 种 方法 称 为 间接 化 。 

间接 化 是 一 种 基础 且 适 用 范围 很 广 的 模块 设计 方法 。 有 这 样 一 句 格 
言 : "计算 机 科学 领域 的 任何 问题 都 可 以 通过 增加 一 个 间接 的 中 间 层 来 解 
决 。 间接 化 有 助 于 维持 低 耦 合 性 ， 保 持 较 高 的 可 维护 性 、 可 扩展 性 与 
可 复 用 性 。 很 多 设计 模式 将 间接 化 作为 基本 思路 之 一 来 使 用 。 

不 过 ， 在 采用 间接 化 这 种 设计 方法 时 ， 我 们 要 掌握 好 它 与 效率 性 之 
间 的 平衡 。 之 所 以 这 么 说 ， 是 因为 间接 化 会 让 处 理 变 得 见长， 对 效率 造 
成 影响 。 

我 们 要 对 软件 所 需 的 效率 性 有 清楚 的 认识 ， 掌 握 好 效率 性 与 可 维护 
性 、 可 扩展 性 和 可 复 用 性 之 间 的 平衡 ， 在 此 基础 上 使 用 间接 化 这 一 设计 
方法 。 
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软件 架构 的 非 功能 需求 @ 
可 靠 性 


= 


英 语 Reliability 





维持 功能 的 能 力 
可 靠 性 指 软件 在 异常 情况 下 或 在 被 非法 、 非 常规 使 用 时 维持 自身 功 
能 的 能 
可 靠 性 体现 在 容错 和 健壮 性 这 两 个 方面 。 

















e 容错 

容错 指 软 件 发 生 故 障 时 仍 保持 正常 运行 的 能 力 。 它 保证 软件 能 在 
异常 情况 下 正常 运行 ， 并 在 内 部 完成 故障 的 修复 工作 。 

修复 完成 后 ， 软 件 需 要 继续 或 从 头 开始 执行 异常 位 置 的 操作 。 比 
如 分 布 式 系 统 在 发 生 通信 骨 常 时 会 先 暂时 切断 连接 ， 等 问题 修复 
完成 后 再 重新 连接 ， 恢 复 软件 的 运行 。 





健壮 性 

健壮 性 是 保护 软件 不 受 非 正常 使 用 方式 或 非法 输入 影响 的 能 力 。 
具备 该 能 力 后 ， 不 论 什 么 样 的 使 用 方式 ， 软 件 都 能 准确 迁移 至 系 
统 定义 的 状态 。 

健壮 性 只 保证 软件 能 迁移 至 系统 定义 的 状态 ， 并 不 要 求 软件 修复 
或 重新 执行 引发 异常 的 处 理 。 
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ELEA 汪 软件 对 可 靠 性 的 需求 各 不 相同 








软件 对 可 靠 性 的 需求 是 不 尽 相 同 的 。 

比如 大 规模 系统 或 关键 的 业务 系统 就 不 允许 出 现 中 断 服务 的 情况 ， 
就 算 缩减 功能 ， 也 要 持续 提供 服务 。 

而 供 个 人 使 用 的 软件 就 不 需要 如 此 强大 的 持续 性 了 。 相 较 于 在 危险 
状态 下 继续 提供 服务 ， 这 类 软件 大 多 选择 保存 数据 重新 启动 。 

因此 ， 在 设计 软件 保 构 时 ,我们 要 先 明确 软件 对 可 靠 性 的 需求 。 


















































宛 余 化 、 故 障 弱 化 和 故障 安全 


从 容错 的 观点 出 发 ， 我 们 可 以 让 软件 架构 存在 内 部 元 余 (双重 元 余 
等 )。 也 可 以 采用 故障 弱化 的 设计 ， 在 软件 发 生 故 障 时 缩减 软件 提供 的 
功能 ， 只 保留 关键 功能 ， 保 证 处 理 继续 进行 。 

从 健壮 性 的 观点 出 发 ， 我 们 可 以 采用 故障 安全 的 设计 ， 在 发 生 故 障 
时 剥离 发 生 故 障 的 部 分 。 也 可 以 采用 故障 保护 的 设计 ， 保 证 软件 在 用 户 
进行 了 错误 操作 的 情况 下 也 能 安全 和 运行， 避免 故障 发 生 。 
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软件 架构 的 非 功能 需求 @ 
可 测试 性 


英 语 Testability 





有效 进行 测试 的 能 


可 测试 性 指 软 件 有 效 且 高 效 地 进行 测试 的 能 

“有 效 地 进行 测试 ” 指 测试 有 深度 且 高 质量 ， 即 通过 测试 可 以 全 面 
检测 软件 的 质量 。“ 高 效 地 进行 测试 ” 指 测试 所 需 成 本 和 劳力 较 少 ， 即 
能 够 花费 较 少 的 成 本 快速 地 检查 软件 的 质量 。 











测试 的 质量 即 产品 的 质量 


随 着 软件 体积 的 增 大 和 软件 复杂 程度 的 加 深 ， 测 试 的 难度 会 越 来 越 
大 ， 所 需 成 本 也 会 越 来 越 高 。 因 此 我 们 要 求 软件 架构 不 仅 要 保证 软件 正 
常 运行 ， 还 要 有 简化 测试 的 效果 。 

无 论 是 开发 阶段 还 是 维护 阶段 ， 保 证 修改 后 软件 的 质量 都 是 一 个 非 
常 重大 的 课题 。 在 软件 的 各 项 需求 中 ， 可 测试 性 的 重要 程度 相对 较 高 。 

简化 软件 的 测试 需要 有 软件 架构 的 支持 。 使 用 能 够 简化 测试 的 软件 
架构 不 仅 方便 调试 代码 和 调试 模块 的 临时 整合 ， 还 可 以 提高 排查 及 修复 
故障 的 效率 。 









































在 设计 产品 时 兼顾 测试 





从 软件 架构 的 设计 阶段 开始 ,我 们 就 要 将 测试 方法 纳入 考虑 的 
范围 。 
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测试 代码 通常 给 人 一 种 正式 代码 附属 物 的 印象 ， 但 实际 上 ， 正 式 代 
码 中 也 可 以 含有 测试 代码 。 这 虽然 与 固有 价值 观 相 冲突 ， 但 从 测试 的 重 
要 程度 来 看 ， 还 是 值得 我 们 让 步 的 。 

提高 可 测试 性 的 关键 在 于 消除 模块 之 间 的 依赖 关系 。 如 果 存 在 依赖 
关系 ， 难 以 测试 的 部 分 就 会 拖 整个 软件 的 后 腿 。 我 们 要 尽量 消除 模块 之 
间 的 依赖 关系 ， 保 证 测试 能 够 以 较 小 的 单位 进行 。 
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软件 架构 的 非 功 能 需求 @ 
可 复 用 性 


-i 


碳 语 Reusability 





过 尼 AA 重复 使 用 与 被 重复 使 用 的 能 





可 复 用 性 指 软件 的 整体 或 其 中 一 部 分 可 以 在 其 他 软件 的 开发 过 程 中 
重复 使 用 的 能 力 。 

可 复 用 性 表现 在 两 个 方面 : 一 个 是 重复 使 用 现 有 代码 的 软件 开发 ; 
男 一 个 是 以 重复 使 用 为 目的 的 软件 开发 。 


























e 重复 使 用 现 有 代码 的 软件 开发 
重复 使 用 现 有 代码 的 软件 开发 指 在 开发 过 程 中 重复 使 用 项 目 内 的 
既 有 模块 、 以 往 项 目的 模块 和 各 种 库 等 。 将 可 重复 使 用 的 现 有 代 
码 直 接 或 变形 后 整合 至 正在 开发 的 软件 中 。 


e 以 重复 使 用 为 目的 的 软件 开发 
以 重复 使 用 为 目的 的 软件 开发 指 在 当前 软件 开发 中 创造 出 可 供 未 
来 项 目 重复 使 用 的 模块 。 为 其 他 软件 提供 可 重复 使 用 的 模块 是 这 
类 软件 开发 的 目的 。 








能 不 做 就 不 做 ， 提 高 开发 效率 


为 了 提高 软件 开发 的 效率 和 软件 质量 ， 我 们 应 该 尽量 避免 从 零 开 
发 。 也 就 是 说 ， 从 其 他 地 方 借用 代码 是 最 好 的 选择 。 
重复 使 用 现 有 代码 可 以 让 我 们 少 编写 一 些 代码 ， 降 低 软件 开发 的 
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成 本 ， 缩 短 周 期 。 同 时 ， 使 用 已 取得 成 绩 的 成 熟 模块 能 够 提高 软件 的 


质量 。 


“插件 ”软件 架构 


如 果 是 重复 使 用 现 有 代码 的 软件 开发 ， 我 们 就 要 设计 出 能 作为 现 有 
结构 或 模块 插件 使 用 的 软件 架构 。 

这 人 么 做 是 为 了 支持 软件 合成 。 软 件 合成 指 通过 利用 现 有 模块 来 组 成 
软件 。 为 达到 这 一 目的 ,我们 需要 实现 能 够 作为 黏合 剂 使 用 的 模块 ， 从 
而 使 现 有 模块 适应 当前 的 开发 需求 。 

如 果 是 以 重复 使 用 为 目的 的 软件 开发 ， 我 们 就 要 设计 出 能 将 自给 自 
足 的 部 分 从 正在 开发 的 软件 中 分 离 出 来 的 软件 架构 。 自 给 自足 的 部 分 要 
能 在 不 进行 任何 修改 的 情况 下 直接 被 其 他 系统 使 用 。 这 部 分 最 好 做 成 可 
独立 构建 的 模块 或 包 。 























E33 重复 使 用 的 “三 之 法 则 ” 


在 创建 可 重复 使 用 的 模块 时 ， 有 两 个 “三 之 法 则 ”。 一 个 是 “三 倍 
难度 法 则 ” ， 另 一 个 是 “三 种 测试 法 则 ”。 

















e 三 倍 难 度 法 则 

该 法 则 指 开 发 可 重复 使 用 的 模块 的 难度 是 开发 在 单一 软件 中 使 用 
的 模块 的 难度 的 三 倍 。 

在 开发 可 重复 使 用 的 模块 时 ， 程 序 员 需要 考虑 一 般 化 问题 的 处 
理 。 除 了 模块 自身 要 做 到 一 般 化 ， 模 块 的 测试 也 必须 能 在 普通 实 
例 中 使 用 。 

因此 ， 模 块 的 可 复 用 性 越 高 ， 复 杂 度 就 越 高 ， 对 想象 力 的 要 求 也 
就 越 高 。 整 个 过 程 的 难度 陡然 提升 。 在 设计 方面 ， 我 们 必须 考虑 
“什么 是 一 般 化 问题 ”; 在 编程 和 测试 方面 ， 我 们 还 需要 考虑 “如 
何 处 理 一 般 化 问题 ”。 
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三 种 测试 法 则 

该 法 则 指 可 重复 使 用 的 模块 在 共享 之 前 需要 在 三 个 不 同 的 软件 中 
通过 测试 。 

可 重复 使 用 的 模块 不 能 满足 于 解决 当前 面 对 的 问题 ， 解 决 更 加 一 
般 化 的 问题 才 是 这 些 模块 要 达到 的 目标 。 

然而 ， 在 开发 模块 时 ， 我 们 很 难 (甚至 不 可 能 ) 将 一 般 化 问题 想 
得 足够 全 面 ， 很 多 问题 只 有 在 实践 中 才 会 暴露 出 来 。 

因此 ， 我 们 不 可 能 一 开始 就 做 出 完美 的 一 般 化 模块 。 比 较 明 每 的 
做 法 是 先 开发 出 原型 ， 然 后 把 它 放 到 实际 的 问题 领域 中 不 断 完善 。 
所 以 ， 用 于 重复 使 用 的 模块 在 开发 完成 之 后 ， 最 少 要 在 三 个 问题 
领域 中 进行 测试 。 


3; 吉 且 二 EE 可 拆 装 组 件 的 框架 


当 我 们 在 同一 问题 领域 实现 多 个 软件 之 后 ,设计 就 会 愈 发 成 熟 ， 进 
而 突破 一 些 壁垒 。 此 时 就 可 以 设计 专攻 该 问题 领域 的 框架 了 。 

框架 就 好 比 确定 了 接口 的 集 线 需 ， 问 题 领域 的 可 变 部 分 是 可 拆 装 的 
组 件 。 和 框架 设计 其 实 就 是 插件 设计 。 

这 是 只 有 极 少数 在 反复 开发 的 过 程 中 获得 成 功 的 幸运 项 目 才能 达到 
的 理想 高 度 ， 达 到 这 个 高 度 的 软件 能 够 自由 地 进行 修改 和 扩展 。 
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七 个 设计 原理 


英 语 Seven design principles 





CA 代码 有 效 性 审查 的 观点 


七 个 设计 原理 是 我 们 在 设计 代码 结构 时 应 考虑 的 核心 观点 ， 目 的 是 
避免 代码 中 存在 故障 隐患 。 
这 些 设计 原理 源 于 对 实际 软件 开发 现场 的 分 析 ， 是 提高 代码 质量 的 
经 验 结晶 。 人 们 从 “怎样 做 才能 在 开发 时 避免 代码 中 存在 故障 隐患 ”的 
角度 出 发 ， 分 析 一 个 个 故障 案例 的 根本 原因 ， 从 而 总 结 出 了 这 些 原理 。 
七 个 设计 原理 是 代码 审查 的 判断 标准 。 这 七 个 设计 原理 如 下 所 示 。 























@ 简单 性 原理 

@ 同 构 原 理 

@ 对 称 原 理 

@ 层次 原理 

@ 线性 原理 (透明 原理 ) 
@ 清晰 原理 

@ 安全 原理 


zi 代码 价值 观 不 遗漏 且 不 动摇 





代码 审查 是 保证 软件 质量 的 有 效 方 法 。 
不 过 ， 审 查 如 果 没 有 一 定 的 价值 观 或 观点 作为 基础 ， 指 出 的 意见 就 
不 会 有 针对 性 。 在 审查 者 不 同 或 者 具体 情况 不 同时 ， 就 会 出 现 观点 遗 
































118 











漏 、 意 见 前 后 不 一 等 情况 ， 审 查 本 身 的 质量 都 难以 保证 。 因 此 ， 我 们 需 
要 七 个 设计 原理 这 种 固定 的 判断 标准 。 

















[3 上 将 七 个 设计 原理 应 用 于 代码 的 编写 








将 七 个 设计 原理 视 为 代码 共同 的 价值 观 ， 用 作 代 码 审查 的 判断 标 
准 。 七 个 设计 原理 也 是 我 们 编写 代码 时 应 该 考虑 的 内 容 。 
在 接 下 来 的 几 节 ， 笔 者 将 对 这 七 个 设计 原理 逐一 进行 介绍 。 
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七 个 设计 原理 


简单 性 原理 


< 


莫 语 Simplicity Principle 





简单 性 原理 就 是 追求 简单 。 

说 得 极端 一 点 ， 就 是 自始至终 都 以 最 简单 的 逻辑 编写 代码 ， 让 编程 
初学 者 一 眼 就 能 看 懂 。 

因此 ， 在 编程 时 我 们 要 重视 的 是 局 部 的 完整 性 ， 而 不 是 复杂 的 整体 
关联 性 。 



































bug 喜欢 出 现在 复杂 的 地 方 


软件 故障 常 集中 在 某 一 个 区 域 ， 而 这 些 区 域 都 有 一 个 共同 的 特点 ， 
那 就 是 复杂 。 编 写 代 码 时 如 果 追 求 简单 易 懂 ， 代 码 就 很 难 出 现 问 题 。 

不 过 ， 简 单 易 懂 的 代码 往往 给 人 一 种 不 够 专业 的 感觉 。 这 也 是 经 验 
老 到 的 程序 员 喜 欢 写 老练 高 深 的 代码 的 原因 。 所 以 我 们 要 有 足够 的 定 力 
来 抵挡 这 种 诱惑 。 






































15YA; 坊 编写 自然 的 代码 





努力 写 出 自然 的 代码 。 放 下 高 超 的 技巧 ， 坚 持 用 简单 的 逻辑 编写 代码 。 
既然 故障 集中 在 代码 复杂 的 区 域 ， 那 我 们 只 要 让 代码 简单 到 让 故障 
无 处 可 藏 即 可 。 不 要 育 目 地 让 代码 复杂 化 、 腾 肿 化 ， 要 保证 代码 简洁 。 
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七 个 设计 原理 @) 


同 构 原理 


英 语 Isomorphism Principle 





AAA 力求 规范 


同 构 原 理 就 是 力求 规范 。 

同等 对 待 相同 的 东西 ， 坚 持 不 搞 特殊 。 同 等 对 待 ， 举 例 来 说 就 
是 同一 个 模块 管理 的 数值 全 部 采用 同一 单位 、 公 有 函数 的 参数 个 数 
统一 等 。 





ELEA 汪 不 同 的 东西 会 更 显眼 


相同 的 东西 用 相同 的 形式 表现 能 够 使 不 同 的 东西 更 加 突出 。 不 同 的 
东西 往往 容易 产生 bug。 遵 循 同 构 原 理 能 让 我 们 更 容易 嗅 出 代码 的 异样 ， 
从 而 找 出 问题 所 在 。 

图 表 和 工业 制品 在 设计 上 追求 平衡 之 美 ， 在 这 一 点 上 ， 同 构 原 理 也 
有 着 相似 之 处 。 统 一 的 代码 颇具 美感 ， 而 美的 东西 一 般 更 容易 让 人 接 
， 因 此 统一 的 代码 有 较 高 的 可 读 性 。 


























着 


过 Ai 编写 符合 规范 的 代码 


我 们 要 让 代码 符合 一 定 的 规范 。 不 过 ， 这 会 与 程序 员 的 自我 表现 欲 
相 冲 突 。 
为 了 展现 自己 的 实力 ， 有 些 程序 员 会 无 视 编程 规范 ， 编 写 独特 的 代 
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代码 变 得 复杂 。 
这 就 把 智慧 与 个 性 用 错 了 地 方 。 小 小 的 自我 满足 远 不 及 代码 质量 重 
要 。 所 以 在 编写 代码 时 ， 务 必 区 制 住 自己 的 表现 欲 ， 以 规范 为 先 。 
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七 个 设计 原理 @) 


对 称 原理 


英 语 Symmetry Principle 





讲究 形式 上 的 对 称 


对 称 原 理 就 是 讲究 形式 上 的 对 称 ， 比 如 有 上 就 有 下 ， 有 左 就 有 右 ， 
有 主动 就 有 被 动 。 

也 就 是 说 ， 我 们 在 思考 一 个 处 理 时 ， 也 要 想到 与 之 成 对 的 处 理 。 比 
如 有 给 标志 位 置 1 的 处 理 ， 就 要 有 给 标志 位 置 0 的 处 理 。 

















史册 帮助 读 代 码 的 人 推测 后 面 的 代码 





具有 对 称 性 的 代码 能 够 帮助 读 代 码 的 人 推测 后 面 的 代码 ， 提 高 其 理 
代码 的 速度 。 同 时 ， 对 称 性 会 给 代码 带 来 美感 ， 这 同样 有 助 于 他 人 理 
代码 。 
此 外 ,设计 代码 时 将 对 称 性 纳入 考虑 的 范围 能 防止 我 们 在 思考 问题 
时 出 现 遗 漏 。 如 果 说 代码 的 条 件 分 支 是 故障 的 温床 ， 那 么 对 称 性 就 是 思 
考 的 框架 ， 能 有 效 阻止 条 件 遗 漏 。 



































la3Ai 守 编写 有 对 称 性 的 代码 


在 出 现 “ 条 件 ” 的 时 候 ， 我 们 要 注意 它 的 “ 反 条 件 "。 每 个 控制 条 
件 都 存在 与 之 成 对 的 反 条 件 ( 与 指示 条 件 相 反 的 条 件 )。 要 注意 条 件 与 
反 条 件 的 统一 ， 保 证 控制 条 件 具 有 统一 性 。 
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我 们 还 要 考虑 到 例外 情况 并 极力 避免 其 发 生 。 例 外 情况 的 特殊 性 会 
破坏 对 称 性 ， 成 为 故障 的 温床 。 特 殊 情 况 过 多 意味 着 需求 没有 得 到 整 
理 。 此 时 应 重新 审视 需求 ， 尽 量 从 代码 中 剔除 例外 情况 。 

命名 也 要 讲究 对 称 性 。 命 名 时 建议 使 用 set/get、start/stop、begin/ 
end 和 push/pop 等 成 对 的 词语 。 























124 


七 个 设计 原理 由 
层次 原理 


英 语 Hierarchy Principle 





Wa 


层次 原理 就 是 在 结构 上 讲究 层次 。 

注意 事物 的 主 从 关系 、 前 后 关系 和 本 未 关系 等 层次 关系 ， 整 理事 物 
的 关联 性 。 

不 同 层次 各 司 其 职 ， 同 种 处 理 不 跨越 多 个 层次 ,这 一 点 非常 重 
要 。 比 如 执行 了 获取 资源 的 处 理 ， 那 么 释放 资源 的 处 理 就 要 在 相同 的 
层次 进行 。 又 比如 互 斥 控制 的 标志 位 置 1 和 置 0 的 处 理 要 在 同一 层次 
进行 。 














IEA 汪 层次 结构 有 助 于 提高 代码 的 可 读 性 


有 明确 层次 结构 的 代码 能 帮助 读 代码 的 人 抽象 理解 代码 的 整体 结 
构 。 读 代码 的 人 可 以 根据 自身 需要 阅读 下 一 层次 的 代码 ， 掌 握 更 加 详细 
的 信息 。 

这 样 一 来 就 可 以 提高 代码 的 可 读 性 ， 帮 助 程序 员 表 达 编 码 意 图 ， 降 
低 bug 发 生 的 概率 。 














(Yi 蚁 编写 有 抽象 层次 结构 的 代码 





在 编写 代码 时 设计 各 部 分 的 抽象 程度 ,构建 层次 结构 。 保 证 同一 个 
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层次 中 的 所 有 代码 抽象 程度 相同 。 
另外 ， 高 层次 的 代码 要 通过 外 部 视角 描述 低层 次 的 代码 。 这 样 做 能 
让 调用 低层 次 代码 的 高 层次 代码 更 加 简单 易 懂 。 
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七 个 设计 原理 @) 


线性 原理 


英 语 Linearity Principle 


别 名 透明 原理 





者 处 理 流程 尽量 走 直线 


线性 原理 就 是 让 处 理 流程 尽量 走 直 线 。 

一 个 功能 如 果 可 以 通过 多 个 功能 的 线性 结合 来 实现 ， 那 它 的 结构 就 
会 非常 简单 。 

反 过 来 ， 用 条 件 分 支 控 制 代 码 、 上 毫 无 章法 地 增加 状态 数 等 行为 会 让 
代码 变 得 难以 理解 。 我 们 要 避免 做 出 这 些 行为 ， 提 高 代码 的 可 读 性 。 

“透明 ”一 词 可 以 用 来 形容 代码 有 较 高 的 可 读 性 ， 所 以 线性 原理 又 
称 为 “透明 原理 ”。 

















5 直线 处 理 可 提高 代码 的 可 读 性 


复杂 的 处 理 流程 是 故障 的 温床 。 

故障 多 出 现在 复杂 的 条 件 语句 和 循环 语句 中 。 另 外 ，goto 等 让 流程 
出 现 跳跃 的 语句 也 是 故障 的 多 发 地 。 

如 果 能 让 处 理由 高 层次 流向 低层 次 ,一 气 呵 成， 代码 的 可 读 性 就 会 
大 幅 提 高 。 与 此 同时 ， 可 维护 性 也 将 提高 ， 添 加 功能 等 改良 工作 将 变 得 
更 加 容易 。 

一 般 来 说 ， 自 上 而 下 的 处 理 流 程 简单 明快 ， 易 于 理解 。 我 们 应 避 开 
复杂 反复 的 处 理 流程 。 
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尽量 不 在 代码 中 使 用 条 件 分 支 


尽量 减少 条 件 分 支 的 数量 ， 编 写 能 让 代码 阅读 者 线性 地 看 完整 个 处 
理 流程 的 代码 。 

为 此 ， 我 们 需要 把 一 些 特殊 的 处 理 拿 到 主 处 理 之 外 。 保 证 处 理 的 统 
一 性 ， 注 意 处 理 的 流程 。 记 得 时 不 时 俯 区 代码 整体 ， 检 查 代码 是 否 存 在 
过 于 复杂 的 部 分 。 

另外 ， 对 于 经 过 长 期 维护 而 变 得 过 于 复杂 的 部 分 ， 我 们 可 以 考虑 对 
其 进行 重 构 。 明 确 且 可 靠 的 设计 不 仅 对 我 们 自 映 有 益 ， 还 可 以 给 负责 维 
护 的 人 带 来 方便 。 
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七 个 设计 原理 @) 


清晰 原理 


英 语 Clarity Principle 





注意 逻辑 的 清晰 性 


清晰 原理 就 是 注意 逻辑 的 清晰 性 。 

逻辑 具有 清晰 性 就 代表 逻辑 能 清楚 证 明 自 身 的 正确 性 。 也 就 是 说 ， 
我 们 编写 的 代码 要 让 人 一 眼 就 能 判断 出 没有 问题 。 任 何不 明确 的 部 分 都 
要 附 有 说 明 。 

保证 逻辑 的 清晰 性 要 “不 择 手 段 "。 在 无 法 用 代码 证 明 逻 辑 正确 性 
的 情况 下 ， 我 们 也 可 以 通过 写 注释 、 附 文档 或 画图 等 方法 来 证 明 。 不 
过 ,证 明 逻 辑 的 正确 性 是 一 件 麻烦 的 事 ， 时 间 一 长 ， 人 们 就 会 懒得 用 辅 
助手 段 去 证 明 ， 转 而 编写 逻辑 清晰 的 代码 了 。 


消除 不 确定 性 


代码 免不了 被 人 一 遍 又 一 遍地 阅读 ， 所 以 代码 必须 保持 较 高 的 可 读 
性 。 编 写 代 码 时 如 果 追 求 高 可 读 性 ， 我 们 就 不 会 采用 取 巧 的 方式 编写 代 
码 ， 编 写 出 的 代码 会 非常 自然 。 

采用 取 巧 的 方式 编写 的 代码 除了 能 让 计算 机 运行 以 外 没有 任何 意 
义 。 代 码 是 给 人 看 的 ， 也 是 由 人 来 修改 的 ， 所 以 我 们 必须 以 人 为 对 象 来 
编写 代码 。 
消除 代码 的 不 确定 性 是 对 自己 的 作品 负责 ， 这 么 做 也 可 以 为 后 续 负 
作 护 的 人 提供 方便 。 













































































涝 
SS 
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二 编写 远 辑 清晰 的 代码 


我 们 要 编写 逻辑 清晰 的 代码 。 

为 此 ， 我 们 应 选用 直观 易 懂 的 逻辑 。 会 给 读 代码 的 人 带 来 疑问 的 部 
分 要 么 消除 ， 要么 加 以 注释 。 
另外 ,我 们 应 使 用 任何 人 都 能 立刻 理解 且 不 存在 于 义 的 术语 。 要 特 
注意 变量 名 等 一 定 不 能 没有 意义 。 
































洱 
jm 





ES 重复 使 用 代码 的 风险 


如 清晰 原理 所 主张 的 那样 ， 代 码 必须 能 让 人 一 眼看 出 其 结构 ， 顺 利 
理解 其 内 容 ， 并 且 没 有 歧义 。 

而 重复 使 用 现 有 代码 必须 建立 在 真正 理解 该 段 代 码 的 基础 之 上 。 

在 硬件 领域 ， 人 们 通过 有 形 的 实物 来 学 习 好 的 设计 。 因 此 ， 只 要 留心 该 
实物 所 处 的 环境 条 件 ， 就 能 实现 可 以 重复 使 用 代码 的 设计 。 

而 在 软件 领域 就 没有 这 人 么 简单 了 。 软 件 的 环境 条 件 是 该 软件 代码 与 
其 他 代码 相互 作用 形成 的 “上 下 文 ”。 所 以 ， 如 果 看 到 代码 被 重复 使 用 
过 就 育 目 拿 来 使 用 ， 软 件 就 可 能 会 出 现 意 想 不 到 的 故障 。 

重复 使 用 代码 是 件 好 事 ， 但 也 存在 风险 。 在 使 用 某 段 代码 之 前 ， 一 
定 要 仔细 确认 其 运行 条 件 和 上 下 文 。 























修复 代码 故障 的 风险 


相 较 于 重复 使 用 ， 在 修复 现 有 代码 的 故障 时 ， 我们 更 需要 去 深入 理 
解 代码 。 

修复 必须 建立 在 充分 理解 代码 的 基础 之 上 ， 否 则 考虑 的 情况 就 会 不 
全 面 ， 导致 代 码 退 化 。 我 们 不 能 只 着 眼 于 发 生 故 障 的 地 方 。“ 代 人 码 能 运 
行 就 好 ”的 思想 并 不 适用 于 修复 现 有 代码 的 故障 。 

我 们 应 充分 理解 代码 ， 充 分 理解 故障 类 型 ， 进 而 提出 假设 ， 然 后 在 
此 基础 上 修复 故障 ， 进 行 全 面 测试 ， 从 而 保证 代码 的 质量 。 
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七 个 设计 原理 CO) 


安全 原理 


= 


莫 语 Safty Principle 





安全 原理 就 是 注意 安全 性 ， 采 用 相对 安全 的 方法 来 对 具有 不 确定 性 
的 、 模 糊 的 部 分 进行 设计 和 编程 。 

说 得 具体 一 点 ， 就 是 在 编写 代码 时 刻意 将 不 可 能 的 条 件 考虑 进去 。 
比如 即便 某 个 if£ 语句 一 定 成 立 ， 我 们 也 要 考虑 else 语句 的 情况 ; 即 
便 某 个 case 语句 一 定 成 立 ， 我 们 也 要 考虑 de fault 语句 的 情况 ; 即 
便 某 个 变量 不 可 能 为 空 ， 我 们 也 要 检查 该 变量 是 否 为 NULL。 


















































zi 防止 故障 发 展 成 重大 事故 


硬件 提供 的 服务 必须 保证 安全 ， 软 件 也 一 样 。 

硬件 方面 ， 比 如 取暖 器 ， 为 防止 倾倒 起 火 ， 取 暖 器 一 般 会 配 有 倾倒 自动 
断 电 装置 。 同 样 ， 设 计 软件 时 也 需要 考虑 各 种 情况 ， 保 证 软件 在 各 种 情况 下 
都 能 安全 地 运行 。 这 一 做 法 在 持续 运营 服务 和 防止 数据 损坏 等 方面 有 着 积极 
的 意义 。 

















二 编写 安全 的 代码 








选择 相对 安全 的 方法 对 具有 不 确定 性 的 部 分 进行 设计 。 列 出 所 有 可 能 
的 运行 情况 ， 确 保 软件 在 每 种 情况 下 都 能 安全 和 运行。 理解 需 求 和 功能 ， 
将 各 种 情况 正确 分 解 到 代码 中 ， 这 样 能 有 效 提高 软件 安全 运行 的 概率 。 
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为 此 ， 我 们 也 要 将 不 可 能 的 条 件 视 为 考察 对 象 ， 对 其 进行 设计 和 纺 
程 。 不 过 ， 为 了 统一 标准 ， 我 们 在 编写 代码 前 最 好 规定 哪些 条 件 需要 
写 ， 哪 些 条件 不 需要 写 。 








S33 后 号 出 代码 的 必要 条 件 与 充分 条 件 


对 代码 的 实现 来 说 ,需求 和 功能 的 说 明 书 只 能 算 必要 条 件 。 
比如 说 明 书 里 写 了 需要 添加 某 项 数据 。 然 而 ， 当 添加 数据 的 操作 使 
数据 库 发 生 错 误 时 ， 说 明 书 并 没有 明确 告诉 我 们 具体 的 应 对 措施 ， 比 如 
继续 处 理 然后 重 试 、 中 止 处 理 并 生成 日 志 、 让 软件 停止 运行 等 。 
如 果 只 能 根据 说 明 书 来 编写 代码 ， 那 么 能 否 写 出 满足 充分 条 件 的 代 
码 ， 就 得 看 程序 员 的 本 事 了 。 

安全 性 是 满足 充分 条 件 必 不 可 少 的 要 素 。 我 们 要 让 代码 在 满足 必要 
条 件 的 同时 准确 涵盖 各 种 功能 和 情况 ， 在 与 用 户 保持 沟通 的 过 程 中 ， 让 
每 个 实例 都 坚实 可 靠 。 
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UNIX 思 想 


英 语 UNIX Culture 





:1 根植 于 UNIX 中 的 约定 俗 成 的 规则 





码 的 实用 性 技术 的 集合 。 

UNIX 思想 并 不 是 真正 意义 上 的 方法 论 ， 它 是 UNIX 文化 孕育 出 的 
一 系列 约定 俗 成 的 规则 ， 被 人 们 沿用 至 今 。 

这 里 我 们 将 UNIX 思想 明文 化 。UNIX 思想 可 总 结 为 以 下 几 个 原则 。 














@ 模块 化 原则 
@ 清晰 原则 
@ 组 合 原则 
@ 分 离 原则 
@ 简单 原则 
@ 简约 原则 
@ 透明 性 原则 
@ 健壮 性 原则 
@ 表达 性 原则 
@ 最 小 意外 原则 
@ 沉默 原则 
@ 修复 原则 
@ 经 济 原 则 
@ 生成 原则 
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@ 优化 原则 
@ 多 样 性 原则 
@ 可 扩展 性 原则 


UNIX 设计 判断 的 正确 性 




















UNIX 拥有 强大 的 生命 力 。 
诞生 于 1969 年 的 UNIX 被 人 们 沿用 至 今 。 从 信息 技术 的 更 新 速度 
来 看 ， 这 确实 是 一 个 做 人 的 成 绩 。 

另外 ，UNIX 适用 于 多 种 硬件 ， 使 用 方法 也 多 种 多 样 。 

UNIX 之 所 以 如 此 成 功 ， 是 因为 UNIX 程序 员 在 设计 初期 进行 了 正 
的 设计 判断 。 这 些 设计 判断 得 到 了 全 世界 优秀 开发 者 的 赞同 ， 并 被 不 
断 完 善 ， 于 是 有 了 今天 的 UNIX。 

这 些 设计 判断 的 精髓 便 是 UNIX 思想 。 


遵循 UNIX 思想 


我 们 要 将 UNIX 思想 的 各 个 原则 作为 设计 的 方针 。 这 些 原 则 都 经 过 
了 历史 的 考验 。 

虽然 UNIX 思想 源 于 UNIX 文化 ,但 它 在 任何 软件 开发 领域 都 有 借 
鉴 意义 。 接 下 来 的 几 节 笔者 将 逐一 讲解 UNIX 思想 的 各 个 原则 。 























et 
































出 处 
[1] 埃 瑞 克 ， S. 理 曼 德 .UNIX 编程 艺术 [M]. 姜 宏 , 何 源 , 蔡 晓 骏 , 译 . 北京 : 
电子 工业 出 版 社 , 2011. 
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UNIX 思想 人 


模块 化 原则 


英 语 Rule of Modularity 





以 精简 的 模块 为 单位 


软件 是 个 复杂 的 东西 。 不 过 ， 软 件 整 体 的 复杂 度 是 可 以 降低 的 。 

为 此 ， 软 件 需 要 由 多 个 简单 的 模块 组 装 而 成 。 

也 就 是 说 ， 将 代码 中 关联 性 较 强 的 元 素 聚 集 起 来 做 成 模块 。 模 块 的 
接口 要 简单 明了 ， 不 能 含有 多 余 的 东西 。 








2 出 | 模块 间 的 关系 应 简洁 





潍 





口 简明 的 简单 模块 不 容易 与 其 他 模块 发 生 关 联 。 因 此 ， 问 题 能 被 
控制 在 局 部 范围 ， 我 们 可 以 在 不 破坏 整体 代码 的 情况 下 修改 对 象 模块 。 

控制 复杂 度 是 编程 的 精髓 。 可 惜 的 是 ， 控 制 复杂 度 没 有 捷径 可 走 。 
我 们 只 能 通过 精简 模块 、 精 简 接 口 来 一 步 一 步 地 降低 软件 的 复杂 度 。 

















1 上 减少 模块 的 接口 


我 们 要 尽量 减少 模块 的 接口 。 

模块 内 部 的 组 成 元 素 之 间 应 具有 较 强 的 关联 性 ， 这 样 我 们 可 以 在 修 
改 某 项 功能 时 将 影响 范围 封闭 在 模块 内 部 。 

在 此 基础 之 上 ， 我们 使 用 这 些 简 单 模块 搭建 整个 软件 。 
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UNIX 思想 @) 


清晰 原则 


英 语 Rule of Clarity 





代码 要 清晰 


代码 不 应 该 巧妙 ， 而 应 该 清晰 。 

以 大 幅 提 升 复杂 度 为 代价 ， 用 技术 使 性 能 得 到 一 点 点 提升 的 做 法 是 
于 了 西瓜 捡 芝麻 。 

复杂 的 代码 不 仅 难以 理解 ， 还 容易 发 生 故 障 。 

而 清晰 的 代码 既 便 于 理解 ， 又 不 容易 出 问题 。 








读 代码 的 是 人 ， 不 是 机 器 


写 代码 时 最 重要 的 一 点 就 是 以 人 阅读 代码 维护 软件 的 程序 员 ) 为 
对 象 ， 不 以 执行 代码 的 计算 机 为 对 象 。 

维护 是 软件 不 可 避免 的 一 个 阶段 。 这 个 阶段 的 所 需 成 本 通常 比重 新 
开发 一 款 软件 的 成 本 还 要 高 。 因 此 ， 代 码 不 是 编译 完 、 解 释 完 之 后 能 在 
计算 机 上 运行 就 万 事 大 吉 了 ， 它 还 必须 能 让 人 读 懂 。 











ls 全 不 清晰 的 地 方 要 进行 改善 





我 们 要 编写 可 读 性 高 的 、 清 晰 的 代码 。 
男 外， 在读 代码 时 ， 不 要 对 难以 读 懂 的 部 分 再 三 解读 。 
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第 一 次 需要 解读 可 能 是 因为 碰 
就 需要 想 办 法 处 理 了 。 





此 时 我 们 可 以 给 代码 添加 注释 ， 





此 来 避免 再 三 解读 同一 段 代码 。 


巧 没 看 懂 ， 如 果 第 二 次 还 需要 角 





或 者 把 代码 修改 得 更 容易 理解 ， 


首 读 ， 


以 
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UNIX 思想 @) 


组 合 原则 


英 语 Rule of Composition 





CA 软件 是 能 组 合 的 过 滤器 











开发 软件 时 要 保证 该 软件 能 和 其 他 软件 组 合 使 用 。 换 句 话说， 就 是 
将 软件 做 成 一 个 尽量 简单 的 过 滤器 。 

这 里 所 说 的 过 滤 吉 是 指 接收 某 种 数据 流 之 后 ， 经 过 加 工 输出 另 一 种 
数据 流 的 软件 。 输 出 的 数据 流 最 好 是 文本 格式 。 





IE 相互 连接 可 产生 协同 效应 


过 滤器 形式 的 软件 能 轻易 地 连接 在 一 起 。 软 件 通 过 不 同 的 组 合 方 
式 ， 能 够 完成 多 种 多 样 的 任务 。 另 外 ,文本 流 的 接口 相对 简单 ， 这 使 得 
软件 能 够 处 于 信息 隐藏 的 状态 。 
而 无 法 与 其 他 软件 协作 的 软件 通常 发 挥 不 出 多 少 价 值 。 即 便 可 以 使 
用 特殊 的 进程 间 通 信 方 式 进行 协作 ， 软 件 也 会 相互 暴露 内 部 结构 。 
能 作为 零件 使 用 的 软件 要 具有 独立 性 。 具 有 独立 性 的 软件 在 与 其 他 
软件 进行 协作 时 ， 几 乎 不 必 考 虑 协作 方 。 最 理想 的 情况 是 一 款 软件 能 在 

影响 协作 方 的 情况 下 ， 轻 松 鞭 换 为 与 自身 实现 方法 完全 不 同 的 软件 。 









































创建 一 个 用 于 输入 输出 文本 的 命令 


设计 一 个 能 在 命令 行使 用 的 读 写 文本 流 的 软件 。 
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和 类 似 于 串 行 通 信 协 议 的 接口 相 比 ， 文 本 流 的 简单 接口 更 值得 选 
择 ， 因 为 这 样 能 方便 我 们 组 合 使 用 多 个 软件 来 完成 不 同 的 工作 。 

当然 ， 在 某 些 情况 下 ,复杂 的 二 进 制 数据 格式 是 无 法 避免 的 。 不 
过 ， 这 种 情况 并 不 常见 。 上 述 做 法 虽然 会 给 扫描 带 来 一 定 的 负担 ,但 与 
自由 读 写 通用 的 文本 流 所 带 来 的 便利 性 相 比 ， 这 点 牺牲 还 是 值得 的 。 
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UNIX 思想 


分 离 原 则 


< 


英 语 Rule of Separation 





2 从 机 制 中 分 离 出 策略 





分 离 原 则 指 从 机 制 中 分 离 出 策略 。 


e 策略 
策略 是 依赖 于 软件 前 提 的 部 分 ， 在 代码 中 相对 不 稳定 。 业 务 罗 辑 
和 用 户 接口 就 属于 策略 。 


e 机 制 
机 制 是 不 依赖 于 软件 前 提 的 自我 独立 的 部 分 ， 在 代码 中 相对 稳 
定 。 绘 图 处 理 的 光栅 操作 算法 等 可 以 起 到 引擎 作用 的 部 分 就 属于 
机 制 。 


AAA 机 制 稳定 ， 策 略 不 稳定 








将 策略 与 机 制 结合 在 一 起 有 两 个 缺点 : 一 是 策略 固化 ， 不 利于 迎合 
用 户 需求 进行 更 改 ; 二 是 修改 策略 时 要 被 迫 修改 已 经 稳定 下 来 的 机 制 。 
将 策略 与 机 制 分 离 可 以 消除 上 述 缺 点 ， 同 时 获得 以 下 好 处 。 

















@ 在 尝试 新 策略 时 不 必 担 心机 制 会 被 破坏 

@ 便于 为 机 制 编写 有 效 的 测试 代码 。 机 制 的 寿命 比较 长 ， 所 以 编写 
测试 代码 是 比较 合适 的 

@ 独立 的 机 制 可 以 被 其 他 软件 重复 使 用 
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比如 UNIX 的 GUI ( Graphical User Imterface， 图 形 用 户 接口 ) 系统 
X Window System 就 只 实现 了 机 制 ， 没 有 实现 策略 。 这 么 做 是 为 了 让 X 
Window System 成 为 通用 的 绘图 引擎 。 

X Window System 将 GUI 的 风格 全 权 交 给 其 他 层次 的 部 件 ( 工具 箱 
等 ) 来 处 理 。 这 个 系统 只 为 我 们 提供 能 构筑 任何 策略 (GUI) 的 机 制 
(绘图 引擎 )。 

之 所 以 这 人 么 做 ， 是 因为 策略 的 变化 远 快 于 机 制 。 用 户 接口 风格 的 流 
行 趋势 日 新 月 异 ， 但 光栅 操作 、 图 形 合成 逻辑 等 并 不 会 经 常 发 生 改 变 。 




















改善 分 离 出 来 的 策略 


对 软件 中 稳定 的 部 分 和 不 稳定 的 部 分 分 开 进 行 管理 ， 比 如 下 面 这 两 
种 设计 。 








e 服务 类 应 用 
将 模块 分 割 成 前 端 与 后 端 。 负 责 理解 通信 协议 、 接 收 客户 端 请 求 
的 前 端 是 策略 ， 实 际 提供 服务 的 后 端 是 机 制 。 
这 样 一 来 ， 两 个 模块 的 复杂 度 就 会 比 实现 相同 功能 的 单一 模块 低 
很 多 ， 从 而 降低 故障 发 生 的 概率 ,减少 软件 整体 的 成 本 。 


e 编辑 类 应 用 
让 用 于 扩展 编辑 器 功能 的 模块 可 通过 设置 文件 来 驱动 。 面 向 用 户 
的 可 扩展 接口 为 策略 ， 编 辑 器 的 引擎 为 机 制 。 
这 样 做 不 仅 可 以 明确 内 部 的 模块 分 割 ， 还 可 以 让 用 户 自由 地 扩展 


功能 。 
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UNIX 思想 @) 


简单 原则 


< 


英 语 Rule ofSimplicity 





IEA 代码 要 简单 


简单 原则 指 将 代码 设计 得 足够 简单 。 

先 探讨 是 否 具有 让 所 有 代码 都 保持 简单 的 条 件 ， 然 后 规定 只 在 必要 
的 情况 下 允许 添加 复杂 代码 。 

不 过 ， 编 程 总 要 面 对 代 码 复杂 化 的 压力 。 要 克服 这 一 点 ， 需 要 整个 
开发 团队 认可 简单 代码 的 价值 。 





IAA 汪 代码 会 自然 而 然 地 变 得 复杂 





下 面 几 点 会 导致 代码 趋 于 复杂 。 











e 程序 员 的 自我 表现 欲 

程序 员 是 一 群 能 够 随心 所 欲 控 制 代码 复杂 度 和 操作 抽象 逻辑 的 联 
明 人 。 因 此 ， 程 序 员 喜欢 与 同事 明 里 暗 里 竞争 “ 谁 写 出 来 的 模块 
但 是 ， 由 此 产生 的 复杂 设计 往往 超出 团队 的 编程 能 力 或 调试 能 
力 ， 结 果 适 得 其 反 ， 最 终 导 致 失败 。 


e 外 部 对 功能 的 需求 
决定 功能 A ed ne 也 不 是 软件 实际 能 提供 的 
服务 。 实 际 上 ， 功 能 是 被 市 场 上 多 变 的 主流 趋势 所 支配 的 。 
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很 多 时 候 ， 销 售 方 只 看 中 功能 的 咏 头 ， 根 本 不 管 该 功能 有 没有 人 
使 用 。 这 种 来 自 销售 方 的 压力 往往 会 破坏 一 些 优秀 的 设计 。 如 今 
功能 方面 的 竞争 已 经 陷入 了 “功能 越 多 越 好 ”的 怪圈 。 其 结果 就 
是 代码 大 幅 增 加 ， 产 生 很 多 规模 巨大 且 容 易 出 现 故障 的 复杂 代 
码 。 最终， 所 有 人 都 深 受 其 定 。 


过量 营造 “简单 即 美丽 ”的 文化 氛围 














要 在 程序 员 之 间 营 造 “简单 即 美丽 ”的 文化 氛围 。 我 们 可 以 尝试 以 
下 几 种 做 法 。 








@ 坚决 抵制 代码 膨胀 及 代码 复杂 化 。 对 简单 的 解决 方法 给 予 好 评 
@ 拒绝 用 大 量 功能 装饰 软件 。 相 反 ， 要 探索 分 割 方法 ， 将 聚集 了 大 
量 功 能 的 软件 分 割 成 相互 协作 的 多 个 零件 
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UNIX 思想 @) 


简约 原则 


英 语 Rule of Parsimony 





AAA 不 与 大 代码 


简约 原则 指 不 写 大 代码 。 这 里 的 “大 ” 既 指 代码 量 大 ， 又 指 代码 内 
部 的 复杂 指数 大 。 
只 要 不 是 别 无 他 法 ， 就 不 要 写 大 代码 。 
写 代码 要 将 雷 ， 尽 量 少 写 ， 让 代码 维持 “小 ”的 状态 。 























出 大 代码 无 法 控制 





一 旦 放任 代码 变 大 ， 其 复杂 度 就 会 上 升 ， 给 维护 带 来 障碍 。 

不 可 否认 ， 曾 经 花费 大 量 劳 力 写 出 来 的 代码 让 人 难以 舍弃 。 但 随 着 
新 代码 的 加 入 ， 代 码 规 模 会 越 来 越 大 ， 早 晚 有 一 天 程序 会 因 过 于 复杂 而 
骨 演 。 














怎么 做 额外 添加 代码 


首先 ， 编 写 规模 小 、 复 杂 度 低 的 代码 。 
如 果 代 码 会 随 着 新 代码 的 添加 而 变 大 ， 我 们 就 得 尽快 对 代码 进行 分 
割 。 除 非 分 割 失 败 ， 和 否则 坚决 不 能 保留 大 代码 。 
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UNIX 思想 @) 


透明 性 原则 


英 语 Rule of Transparency 





2 出 让 软件 运行 变 得 可 见 


在 设计 软件 时 ， 要 保证 我 们 能 从 外 部 清楚 看 到 软件 的 运行 状态 。 
也 就 是 说 ， 我 们 不 仅 要 让 软件 正确 运行 ， 还 要 让 人 能 看 到 它 在 正确 地 
运行 。 


为 此 ,在 设计 时 我 们 要 注意 下 面 所 讲 的 透明 性 和 公示 性 。 





























@ 透明 性 : 软件 的 运行 要 让 人 一 眼 就 能 理解 “软件 正在 做 什么 ”以 
及 “软件 是 怎么 做 的 ” 
@ 公示 性 : 可 以 监视 或 表现 软件 的 内 部 状态 


z5giE AAA 有 助 于 调试 








具有 透明 性 和 公示 性 的 设计 虽然 不 会 对 用 户 有 什么 直接 的 贡献 ， 但 
对 整个 项 目 有 着 潜在 的 正面 影响 。 

之 所 以 这 么 说 ， 是 因为 当 软 件 的 运行 状态 变 得 可 见 时 ,调试 和 故障 
排查 会 变 得 更 加 省 力 。 调 试 会 占用 开发 周期 的 大 部 分 时 间 ， 在 早期 引入 
简化 调试 的 机 制 是 一 项 收效 颇 丰 的 投资 。 为 调试 而 生 的 功能 绝对 不 是 附 
属 品 。 

另外 ， 以 透明 性 和 公示 性 为 目标 ， 更 容易 获得 用 于 软件 间 协 作 的 简 
单 接口 ， 从 而 便于 开发 者 使 用 其 他 开发 工具 (特别 是 Test harness、 
Profiler 和 调试 脚本 等 ) 操作 软件 。 
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过 5 恒 编 写 “ 软 件 运行 可 见 化 ”功能 


我 们 可 以 在 软件 设计 初期 加 入 用 于 调试 的 功能 ， 比 如 加 入 以 字符 串 
形式 输出 模块 内 变量 内 容 的 方法 、 大 量 生成 日 志 等 。 

在 编写 一 般 功能 时 ， 将 这 些 能 让 软件 运行 可 见 化 的 功能 一 并 写 入 代 
码 中 。 在 正式 代码 中 加 入 简化 调试 的 机 制 是 一 件 好 事 ， 不 必 犹 驳 。 


Sy 
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UNIX 思想 @ 


健壮 性 原则 


英 语 Rule of Robustness 





2 出 使 软件 具有 健壮 性 





健壮 性 原则 指 让 软件 具有 健壮 性 。 
健壮 的 软件 不 仅 能 在 一 般 条 件 下 正常 运行 ， 还 能 在 预想 之 外 的 条 件 
下 提供 适当 的 服务 。 健 壮 性 也 可 以 称 为 坚固 性 。 

不 过 ， 编 程 时 如 果 将 预想 之 外 的 条 件 也 纳入 考虑 范围 ， 代 码 就 会 变 
得 复杂 。 随 着 复杂 度 的 提升 ， 代 码 最 终 会 超出 人 脑 的 理解 范围 。 如 此 一 
来 ， 代 码 发 生 故 障 的 概率 就 会 大 幅 提 升 。 软 件 失去 健壮 性 ， 陷 入 进退 两 
难 的 境地 。 

所 以 ， 要 想 使 软件 具有 健壮 性 ， 必 须 保 证 人 们 能 轻松 识别 其 内 部 结 
构 。 为 此 我 们 需要 编写 具有 透明 性 和 简单 性 的 代码 。 
























































@ 透明 性 : 可 读 性 高 ， 软 件 运行 一 目 了 然 ， 这 样 的 代码 就 是 透明 的 
@ 简单 性 : 代码 要 完成 的 任务 不 复杂 ， 所 有 的 分 支 条 件 都 能 简单 说 
明 ， 这 样 的 代码 就 是 简单 的 


RE 出 软件 必须 足够 坚固 











与 健壮 的 软件 相 比 ， 不 具备 健壮 性 的 软件 为 用 户 提 供 的 价值 明显 偏 
低 。 如 果 一 款 软件 用 不 了 多 长 时 间 就 出 问题 ， 那 它 肯定 无 法 为 用 户 提供 
优质 的 服务 。 如 果 一 有 输入 错误 软件 就 会 卡 死 ， 那 么 对 于 这 样 的 软件 ， 
用 户 也 不 可 能 买账 。 





























147 





为 保证 健壮 性 ， 软 件 必 须 能 让 人 轻松 识别 其 内 部 结构 。 如 果 读 代码 
的 人 无 法 轻松 说 明代 码 的 内 部 结构 ， 就 证 明代 码 不 具备 透明 性 ， 自 然 也 
不 具备 健壮 性 。 另 外 ,在 出 现 问题 时 ， 过 高 的 复杂 度 会 妨碍 维护 人 员 理 
解 代码 ， 使 维护 人 员 无 法 通过 修改 代码 来 保证 软件 的 健壮 性 。 









































二 让 代码 透明 化 和 简单 化 
要 时 常 保持 代码 透明 和 简单 。 为 此 ， 我 们 需要 做 到 以 下 两 点 。 


e 代码 审查 
如 果 编 写 代码 的 程序 员 无 法 准确 说 明代 码 的 内 部 结构 ， 就 表示 这 
段 代码 暗藏 危险 。 


e 检查 软件 是 否 能 承受 例外 输入 的 考验 
将 其 他 软件 给 出 的 结果 用 作 输 入 可 以 提升 测试 效率 。 相 较 于 手动 
和 输入， 这么 做 更 能 对 自己 编写 的 软件 形成 压力 。 
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UNIX 思想 () 


表达 性 原则 


英 语 Rule ofRepresentation 





尽量 用 数据 表达 信息 





代码 中 的 信息 要 尽量 用 数据 而 非 逻 辑 来 表达 。 

将 信息 固定 在 数据 一 侧 ， 可 以 提高 逻辑 的 可 读 性 与 健壮 性 。 

数据 不 论 多 么 复杂 都 能 被 轻松 地 模型 化 。 用 数据 来 表达 信息 也 更 加 
简单 。 

















ME 出 数据 比 逻辑 更 好 控制 


对 人 类 而 言 ， 过 程 逻 辑 并 不 是 很 好 理解 ,但 复杂 的 数据 结构 理解 起 
来 并 没有 那么 难 。 所 以 说 数据 比 逻 辑 更 好 控制 。 

比如 用 于 表示 换算 表 的 数组 的 初始 化 语句 与 表示 相同 内 容 的 switch 
语句 相 比 ， 数 据 结构 一 方 更 容易 理解 。 不 论 表 达能 力 还 是 信息 量 ， 数 据 
结构 都 有 着 明显 的 优势 。 





























[Yi 全 把 复杂 的 部 分 交 给 数据 














我 们 要 尽量 把 代码 中 无 法 避免 的 复杂 部 分 交 给 数据 表示 。 当 遇 到 
数据 和 人 逻辑 必须 有 一 个 复杂 化 的 情况 时 ， 我 们 要 毫 不 犹 光 地 选择 让 数据 
复杂 化 。 

在 优化 代码 时 ， 也 可 以 考虑 将 代码 的 复杂 性 转移 给 数据 。 
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UNIX 思想 人 0 


最 小 意外 原则 


英 语 Rule of Least Surprise 





导出 接口 的 设计 要 符合 使 用 者 的 想象 





接口 的 设计 尽量 不 要 让 使 用 者 感到 意外 。 
设计 接口 时 要 避 开 无 意义 的 新 奇 设计 以 及 过 度 取 巧 的 设计 。 








ELEA 降 低 学 习 成 本 








什么 样 的 软件 用 起 来 最 简单 ? 答案 是 需要 用 户 学 习 的 东西 最 少 的 软 
件 ， 即 用 户 利 用 已 有 知识 就 能 进行 操作 的 软件 。 

这 种 软件 能 够 按 用 户 的 预期 运行 ,没有 门槛 ， 不 会 给 用 户 带 来 压 
力 ， 因 此 能 被 用 户 长 期 使 用 。 














活用 用 户 的 已 有 知识 


在 设计 接口 时 ， 我 们 要 让 接口 的 运行 符合 用 户 的 预期 。 为 此 ， 我 们 
需要 注意 以 下 几 点 。 








e 参考 类 似 的 软件 来 设计 接口 
我 们 可 以 参考 用 户 常用 的 、 功 能 类 似 的 软件 来 设计 接口 。 以 开发 
计算 型 软件 为 例 ， 就 是 “+” 必 须 和 计算 器 一 样 永远 表示 加 法 。 
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。 考虑 目标 用 户 的 特征 
最 终 用 户 、 其 他 程序 员 、 系 统管 理 者 …… 用 户 类 型 不 同 ， 能 给 用 
户 带 来 最 小 意外 的 接口 也 不 同 。 


e 注意 传统 

在 UNIX 的 世界 中 ， 配 置 、 运 行 控制 文件 的 格式 和 命令 行 开关 等 
都 包含 了 一 些 约 定 俗 成 的 东西 。 

传统 的 形成 是 为 了 让 学 习 更 加 简单 。 我 们 要 学 习 这 些 传统 ， 并 将 
其 活用 到 需求 的 设 定 中 。 


。 避免 “相似 但 稍 有 不 同 ” 

人 们 往往 希望 眼前 熟悉 的 东西 就 是 自己 熟知 的 东西 ， 但 希望 越 
大 ， 落 空 时 的 失望 就 会 越 大 。 与 其 编写 一 款 与 现 有 软件 相似 的 产 
品 ， 不 如 直接 做 一 款 完全 不 同 的 产品 。 





不 光 是 软件 的 接口 ， 编 程 的 接口 也 是 如 此 。 假 设 有 一 个 从 模块 取 值 
的 函数 get。 如 果 要 获取 远程 模块 的 值 ， 就 不 应 该 使 用 “get” 这 个 名 
称 。 虽然 从 取 值 的 意义 上 来 说 ， 这 个 名 称 没有 问题 , 但 “get” 会 给 人 一 
种 获取 当前 模块 中 某 个 值 的 感觉 。 当 获取 远程 模块 的 值 时 ， 准 备 一 个 完 
全 不 同 的 fetch 函数 可 以 降低 使 用 者 的 意外 程度 。 
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UNIX 思想 @ 


沉默 原则 


英 语 Rule of Silence 





软件 应 “沉默 寡言 ” 


软件 应 将 显示 内 容 控制 在 最 少 的 程度 ， 默 默 执 行 自己 的 工作 。 

除非 遇 到 必须 提醒 的 情况 ， 否 则 软件 应 “什么 都 不 说 ”。 

不 论 对 软件 的 用 户 而 言 ， 还 是 对 和 软件 相连 接 的 软件 而 言 ,，“ 沉 默 
寡言 ”的 软件 都 要 比 “ 唆 唆 不 体 ” 的 软件 好 相处 。 








能 更 好 地 传达 重要 信息 


“沉默 是 金 ” 同 样 适用 于 软件 。 
如 果 输 出 内 容 过 多 ， 用 户 就 难以 分 辨 哪些 信息 对 自己 来 说 比较 重 
要 ,还 有 可 能 在 下 拉 深 动 条 时 错过 重要 的 信息 。 

如 果 软 件 能 保证 只 显示 重要 的 信息 ， 用 户 就 不 必 自 己 再 去 筛选 信息 
了 。 用 户 的 注意 力 和 精力 是 宝贵 的 有 限 资 源 ， 好 钢 要 用 在 刀 丸 上 。 

另外 ， 软 件 的 输出 有 时 会 用 作 其 他 软件 的 输入 。 此 时 的 信息 如 果 玉 
石 混 淆 ， 就 会 影响 到 软件 与 其 他 软件 的 连接 ， 所 以 软件 必须 保证 能 让 其 
他 软件 轻松 提取 所 需 信 息 。 

有 些 软件 在 运行 开始 和 和 运行 结束 时 会 分 别 显示 “应 用 程序 正在 启 
动 ” 和 “应 用 程序 正在 关闭 ”的 信息 。 其 实 这 些 信息 并 没有 什么 意义 ， 
因为 它们 都 是 用 户 知晓 的 内 容 ， 而 且 与 该 软件 相连 接 的 软件 也 不 会 将 这 
些 信息 用 作 输 入 数据 。 























I 
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5 只 输出 重要 的 信息 





将 输出 的 信息 控制 到 最 少 。 只 输出 重要 的 信息 ， 内 部 运行 的 信息 不 
要 摊 杂 其 中 。 
下 面 两 条 可 视 为 沉默 原则 的 指导 方针 。 














@ 在 发 生 错 误 时 只 将 真正 错误 的 部 分 作为 标准 错误 输出 ， 不 输出 所 
需 范围 之 外 的 任何 数据 

@ 如 果 因 为 调试 而 需要 输出 信息 来 显示 当前 运行 状况 ， 则 可 以 制作 
一 个 具有 宛 余 模式 的 开关 ， 并 让 开关 默认 处 于 关闭 状态 
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UNIX 思想 @ 


修复 原则 


英 语 Rule of Repair 





志恒 修复 失败 时 停止 处 理 


在 软件 运行 的 过 程 中 ,一旦 出 现 错误 且 修 复 失 败 ， 就 应 立刻 停止 处 理 。 

此 外 ， 软 件 发 生 错误 时 要 有 明显 的 提示 。 

不 论 在 正常 情况 下 还 是 在 出 现 问题 的 情况 下 ， 软 件 的 运行 过 程 都 应 该 
保持 透明 。 在 陷入 混沌 的 局 面 之 前 ， 软 件 应 引发 明显 的 错误 ， 中 断 处 理 。 











ziEA 出 错时 继续 运行 容易 扩大 损害 


在 遇 到 预想 之 外 的 情况 时 ， 软 件 若 能 恰当 应 对 ， 就 不 会 出 现任 何 问 
题 。 即 便 不 能 ， 在 某 些 情况 下 ， 软 件 也 可 以 通过 修复 来 回 到 正常 状态 。 

然而 ， 如 果 软 件 在 修复 失败 的 情况 下 继续 执行 处 理 ， 就 会 出 现 最 坏 的 
结果 。 故 障 可 能 会 在 不 知 不 觉 间 破坏 所 有 数据 。 我 们 发 现 问题 时 已 经 晚 了 。 

如 果 只 是 软件 暂时 无 法 正常 运行 ， 倒 也 不 算 可 怕 ， 可 怕 的 是 有 时 候 
故障 会 悄悄 地 破坏 用 户 的 重要 数据 。 这 种 破坏 会 带 来 巨大 的 损失 ， 酿 成 
不 可 挽回 的 后 果 。 























错误 提示 要 “ 震 耳 从 


软件 在 发 生 错误 时 应 尽早 发 出 能 让 人 立刻 知晓 的 通知 。 软 件 在 无 法 
自行 修复 错误 时 要 停止 处 理 ， 尽 早 提醒 用 户 ， 让 用 户 进行 判断 ， 这 一 点 
非常 重要 。 
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不 过 ， 对 于 用 户 的 非法 输入 和 软件 自身 的 执行 错误 ， 软 件 要 先 适 当 
地 进行 一 下 处 理 ， 如 果 条 件 不 允许 ， 再 立刻 引发 一 个 容易 诊断 的 错误 。 








E33 后 后 章 软件 输入 输出 相关 的 和 驴 言 





关于 软件 的 输入 和 输出， 有 一 种 观点 是 “接收 输入 时 采取 自由 主义 的 
态度 ， 发 送 输出 时 采取 保守 主义 的 态度 ”。 具 体 来 说 ， 就 是 在 接收 输入 
时 ， 即 便 输入 格式 有 误 ， 软 件 也 应 当 尽 量 推测 出 其 正确 的 含义 ， 宽 容 接 
纳 ; 在 发 送 输出 时 ， 软 件 应 保证 输出 数据 严 说、 整洁 和 正确 。 这 人 名 做 言 
原本 用 于 网 络 软件 ， 但 它 的 思想 也 适用 于 其 他 领域 。 

不 过 ， 对 输入 过 于 宽容 也 会 带 来 一 些 问题 。HTML 就 是 一 个 对 输入 
过 于 宽容 从 而 酿 成 苦果 的 典型 案例 。 不 同 的 浏览 器 会 选择 不 同 的 超 集 ， 
这 就 导致 不 同 的 浏览 需 呈 现 出 的 效果 各 不 相同 。 

软件 应 当 对 “运行 方式 ”而 不 是 “运行 方式 的 解释 ”采取 宽容 的 态 
度 。 我 们 在 制定 规则 时 ， 对 于 那些 “怎样 实现 都 可 以 ”的 宽泛 标准 一 定 
不 能 妥协 。 
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UNIX 思想 四 


经 济 原则 


< 


英 语 Rule of Economy 





珍惜 程序 员 的 时 间 


程序 员 的 时 间 是 宝贵 资源 ， 值 得 珍惜 。 
下 面 列 出 的 几 个 问题 会 浪费 程序 员 的 时 间 。 


NS 














e 硬件 性 能 不 
开发 的 机 器 性 色 2 时 间 的 常见 因素 之 一 。 
当 存 储 空间 不 足 时 ， 压 缩 和 转 储 操作 就 会 变 多 ， 从 而 消耗 大 量 时 
间 ; 当 CPU 的 性 能 不 足 时 ， 编 译 和 执行 方面 就 会 花费 大 量 时 间 ， 
导致 程序 员 的 等 待 时 间 增 加 ; 当 内 存 不 足 时 ， 可 同时 执行 的 软件 
数量 就 会 变 少 ， 寻 致 开发 效率 低下 ; 当 显 示 器 太 小 时 ， 程 序 员 就 
要 不 断 切换 窗口 ， 这 就 降低 了 工作 效率 。 


e 可 用 软件 的 限制 
在 无 法 购买 所 需 软 件 的 情况 下 ， 程 序 员 就 需要 花费 很 多 精力 来 实 
现 相 应 的 功能 。 
另外 ， 有 些 团队 还 限制 免费 软件 的 安装 。 在 无 法 安装 工具 的 情况 
下 ,很 多 工作 就 需要 手动 完成 了 。 


e 环境 相关 的 规则 或 限制 
在 开发 过 程 中 需要 用 到 某 个 网 站 ， 开 发 环境 却 无 法 访问 该 网 站 。 
这 种 情况 很 常见 。 有 些 团队 还 会 规定 不 允许 使 用 云端 软件 ， 其 至 
不 允许 连接 网 络 。 
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然而 ， 信 息 处 理 技术 人 员 是 不 能 与 信息 相隔 绝 的 。 


ELEAA 汪 程序 员 的 时 间 很 宝贵 


不 选择 购买 硬件 或 软件 通常 是 为 了 节约 经 费 。 然 而 设备 的 费用 与 花 
在 程序 员 身 上 的 费用 相 比 ， 后 者 要 远 远 高 于 前 者 。 如 果 对 设备 进行 投资 
提高 程序 员 的 工作 效率 ， 让 程序 员 和 舒心 工作 ， 那 么 这 部 分 投资 很 快 就 
回 本 。 

另外 ， 保 证 安全 性 是 制定 规章 制度 的 主要 目的 。 但 如 果 规 章 制 度 阻 
但 了 开发 ， 降 低 了 商业 效率 ， 那 就 本 未 倒置 了 。 越 优秀 的 程序 员 越 容易 
被 规章 制度 束缚 ， 失 去 工作 热情 。 


对 设备 进行 投资 


购买 一 些 能 优化 开发 环境 的 软件 和 硬件 。 对 设备 进行 投资 就 相当 于 
间接 在 程序 员 身 上 投资 ， 如 此 一 来 ， 收 支 必 然 为 正 。 这 么 做 可 以 提高 开 
发 效率 ,减轻 程序 员 的 工作 压力 ， 从 而 大 幅 提 高 生产 效率 和 产品 质量 。 

另外 ， 实 施 规章 制度 后 要 适度 对 其 进行 调整 。 将 最 初 制定 的 规章 制 
度 视 为 基础 方案 ， 在 实施 这 些 规章 制度 之 后 ， 也 要 听取 程序 员 的 意见 。 
规章 制度 如 果 阻 碍 了 开发 ， 就 要 在 可 能 的 范围 内 做 出 最 大 的 让 步 。 
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UNIX 思想 人 @ 


生成 原则 


英 语 Rule of Generation 





已 A 编 号 “用 于 生成 代码 ”的 代码 





生成 原则 指 编写 用 于 生成 代码 的 代码 ， 也 就 是 用 我 们 写 出 来 的 代码 
来 生成 代码 。 

我 们 要 减少 手动 操作 ， 编 写 用 于 生成 代码 的 代码 。 

不 必 强 求 所 有 代码 都 通过 这 种 方式 生成 。 只 要 在 可 能 的 范围 内 生成 
部 分 合适 的 代码 即 可 。 





AAA 生成 出 来 的 代码 成 本 低 且 质量 高 


人 类 并 不 擅长 做 细致 的 工作 。 因 此 ， 手 动 操作 代码 会 麻 兽 人 的 感 
觉 ， 导 致 工作 进度 过 慢 或 工作 出 现 失 误 。 

而 生成 的 代码 通常 比 程序 员 手 写 的 代码 成 本 低 且 质量 高 。 这 也 是 编 
译 器 和 解释 器 存在 的 意义 。 

这 一 点 的 正确 性 大 家 都 知道 ， 但 很 少 有 人 在 日 常 工作 中 注意 到 它 。 



































壹 坟 恒 编写 代码 生成 器 


我 们 可 以 在 适当 的 地 方 编写 代码 生成 器 。 
只 在 有 限 的 范围 内 生成 代码 也 是 很 有 效果 的 。 
重复 的 、 形 式 固定 的 代码 尤其 适合 由 代码 生成 器 生成 。 
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UNIX 思想 四 


优化 原则 


英 语 Rule ofOptimization 





二 出 代码 的 正确 性 优 于 运行 速度 








区 


程 中 的 优化 指 性 能 调 优 ， 其 中 包括 提高 运行 速度 、 优 化 内 存 和 硬 








盘 等 计算 机 资源 的 使 用 率 等 。 





但 是 在 优化 代码 之 前 ， 我 们 首先 要 保证 的 是 代码 能 正常 运行 。 
在 代码 尚 不 能 充分 运行 的 阶段 ， 对 细节 进行 打磨 是 一 种 吃力 不 讨好 




















的 做 法 。 为 了 那 仅 有 的 一 点 成 果 ， 我 们 往往 需要 耗费 大 量 的 时 间 。 





ze 在 较 早 的 阶段 追求 运行 速度 会 破坏 设计 














在 没有 确认 代码 能 正确 运行 之 前 就 开始 优化 会 破坏 代码 的 设计 。 
之 所 以 这 么 说 ， 是 因为 此 时 追求 优化 会 引起 以 下 问题 。 





e 会 牺牲 代码 的 透明 性 和 简单 性 
此 时 追求 优化 会 使 代码 变 得 上 涩 ， 内 部 构造 难以 辩 认 ， 从 而 产生 
诸多 故障 ， 浪 费 大 量 时 间 。 我 们 花费 大 量 时 间 进 行 调试 换 来 的 只 
是 价值 极 低 、 效 果 其 微 的 高 速 化 ， 以 及 一 点 点 计算 机 资源 使 用 量 
的 减少 。 


。 贸然 对 局 部 进行 优化 可 能 会 妨碍 代码 整体 的 优化 
对 代码 整体 进行 优化 能 带 来 最 大 收益 ， 而 贸然 对 局 部 进行 优化 会 
妨碍 代码 整体 的 优化 。 贸 然 对 局 部 进行 优化 不 仅 会 降低 软件 性 


能 ， 还 会 留 下 许多 过 于 复杂 的 代码 。 
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过量 先 确保 代码 的 正确 性 再 想 办 法 提高 运行 速度 











先 确 保 软件 能 正确 运行 ， 然 后 想 办 法 提升 运行 速度 。 在 编程 时 ， 一 
定 要 牢 牢 记 住 这 个 顺序 。 

未 经 优化 的 代码 运行 缓慢 ， 还 会 消耗 大 量 的 计算 机 资源 。 在 优化 之 
前 ， 我 们 要 先 编写 这 种 未 经 优化 的 代码 。 这 一 阶段 至 少 要 保证 代码 足够 
简单 ， 没 有 过 高 的 复杂 度 。 之 后 ， 我 们 再 系统 地 寻找 能 获得 最 大 优化 效 
果 的 地 方 进行 优化 。 

代码 越 简单 ， 可 优化 之 处 就 越 容 易 被 找到 。 


























5 优化 试制 品 





从 优化 的 角度 来 说 ， 先 做 一 个 能 运行 的 试制 品 也 是 一 种 不 错 的 
做 法 。 

通过 试制 品 ， 我 们 能 发 现 哪些 功能 没有 必要 编写 。 少 写 一 部 分 代码 
自然 能 提升 性 能 ， 因 为 不 用 写 的 那 部 分 代码 根本 谈 不 上 优化 。 

“最 有 力 的 优化 工具 是 删除 键 ”“ 生 产 效率 最 高 的 日 子 就 是 删除 了 
1000 行 代 码 的 日 子 ”， 这 些 颇 具 讽刺 意味 的 格言 充分 说 明了 代码 简洁 对 
优化 的 重要 性 。 
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UNIX 思想 四 


多 样 性 原则 


英 语 Rule of Diversity 





容许 有 多 样 的 选择 


软件 开发 应 容许 存在 多 种 方法 。 
软件 开发 不 存在 “唯一 正确 的 方法 ”。 我 们 不 能 相信 任何 宣称 软件 
开发 存在 唯一 正确 方法 的 言论 。 




















egA 人 的 想象 力 是 有 限 的 


从 原理 上 讲 ， 软 件 开发 不 可 能 存在 唯一 正确 的 方法 。 

人 的 想象 力 是 有 限 的 。 即 便 有 人 能 让 软件 的 各 个 地 方 都 实现 最 优 ， 
他 也 预测 不 到 软件 的 所 有 用 途 。 

“存在 唯一 正确 的 方法 ”这 种 态度 既 狂 妄 又 不 成 熟 。 























志恒 不 懈 追 求 更 好 的 方案 


在 编程 领域 ， 对 于 任何 宣扬 “存在 唯一 正确 方法 ”的 言论 都 应 持 怀 
疑 态度。 在 此 基础 上 ， 我 们 要 认可 多 样 性 ， 调 动 思维 ， 不 断 寻 找 更 好 的 
方案 。 不 能 认为 软件 功能 存在 唯一 正确 的 规格 。 

另外 ， 只 进行 一 次 发 布 不 可 能 满足 用 户 的 所 有 需求 。 所 以 我 们 要 让 
软件 足够 开放 ， 并 且 具 有 较 高 的 可 扩展 性 ， 以 此 来 提高 软件 间 相 互 协作 
的 可 能 性 。 我 们 也 可 以 通过 添加 选项 和 hook 来 让 用 户 自 定义 软件 。 总 
之 ,我 们 要 设计 出 灵活 度 较 高 的 软件 。 
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UNIX 思想 @ 


可 扩展 性 原则 


英 语 Rule of Extensibility 





设计 时 留 有 扩展 的 余地 


我 们 在 设计 软件 时 要 考虑 到 可 扩展 性 。 

软件 开发 不 存在 “唯一 正确 的 方法 ”。 将 自己 的 设计 看 作 “ 唯 一 正 
确 的 方法 ”是 很 危险 的 。 因 此 ， 代 码 一 定 要 留 有 扩展 的 余地 。 通 过 扩 
展 ， 代 码 能 满足 多 样 的 需求 。 

未 来 比 我 们 想象 中 来 得 更 快 ， 所 以 设计 一 定 要 着 眼 于 未 来 。 


























hE 出 软件 必须 扩展 














如 果 不 事先 考虑 可 扩展 性 ， 我 们 就 无 法 在 保持 软件 兼容 性 的 情况 下 
改写 代码 。 一 旦 如 此 ， 软 件 就 会 被 最 初 的 设计 所 束缚 ， 无 法 成 长 。 

最 初 的 设计 不 可 能 完美 无 缺 ， 况 且 用 户 的 需求 还 会 不 断 发 生变 化 。 

软件 若 想 长 期 被 用 户 使 用 ， 就 得 不 断 成 长 。 




















li 祷 可 插 拔 式 设计 


我 们 要 采用 可 插 拔 式 设计 。 

对 于 以 扩展 为 目的 的 可 插 拨 接 口 部 分 ,我 们 要 采用 灵活 的 设计 ， 并 
在 代码 一 旁 加 上 “如 果 需 要 x x ”的 注释 。 这 是 对 将 来 使 用 、 维 护 代 码 
的 人 应 尽 的 义务 。 即 便 将 来 维护 这 部 分 代码 的 人 是 自己 ,我 们 也 可 能 会 
忘记 相关 内 容 。 所 以 这 种 着 眼 于 未 来 的 设计 也 为 自己 提供 了 方便 。 
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不 过 ， 可 扩展 性 并 不 是 添加 非 必 要 功能 的 免 罪 符 。 事 先 添加 的 功 
能 大 多 没有 用 武之 地 ， 我 们 要 编写 能 在 需要 的 时 候 轻 松 添加 相应 功能 的 
代码 。 





具有 自我 描述 性 的 数据 格式 





可 扩展 性 原则 同样 适用 于 数据 格式 〈 数 据 布局 与 数据 格式 )。 

在 设计 协议 或 文件 格式 时 ， 要 让 数据 格式 具有 自我 描述 性 和 可 扩 
展 性 。 

我 们 可 以 通过 添加 版 本 号 来 实现 上 述 内 容 。 不 过 ， 让 数据 格式 由 几 
个 独立 的 自我 描述 的 部 分 组 成 能 取得 更 好 的 效果 。 这 人 么 做 可 以 在 不 搞 混 
所 读 取 的 代码 的 前 提 下 添加 新 的 部 分 或 删除 旧 的 部 分 。 

证 数据 格式 具有 自我 描述 性 是 一 项 很 小 的 投资 ， 但 这 项 投资 可 以 使 
我 们 获得 丰厚 的 回报 一 一 在 不 影响 已 有 代码 的 前 提 下 扩展 数据 格式 。 
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UNIX 哲 学 


英 语 UNIX Philosophy 





局 尼 A 支撑 UNIX 的 哲学 


UNIX 哲学 指 UNIX 背后 的 设计 哲学 ， 也 就 是 UNIX 思维。 
UNIX 哲学 可 以 总 结 为 以 下 几 个 定理 。 


@ 小 就 是 美 

@ 工作 唯一 

@ 尽早 创建 原型 

@ 可 移植 性 优先 于 效率 

@ 文本 数据 

@ 充分 利用 软件 的 杠杆 效应 
@ 活用 shell 脚 本 

@ 避 开 交互 式 用 户 接口 

@ 过 滤器 化 


UNIX 哲学 具有 普遍 价值 




















UNIX 拥有 很 长 的 历史 ， 至 今 仍 被 人 们 用 在 开发 的 第 一 线 。 这 是 因 
为 UNIX 的 设计 哲学 非常 优秀 旦 具有 普遍 价值 。 

最 好 的 证 据 就 是 UNIX 中 使 用 的 点 子 在 其 他 软件 的 开发 中 得 到 了 
应 用 。 
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有 5 量 活用 UNIX 哲学 








我 们 要 将 UNIX 哲学 活用 到 设计 方针 及 编程 中 。 
掌握 设计 哲学 背后 潜藏 的 理由 能 帮助 我 们 选择 合适 的 方针 。 
接 下 来 的 几 节 笔者 将 逐一 说 明 UNIX 哲学 的 各 个 定理 。 


















































出 处 


[1] Mike Gancarz. The Unix Philosophy[M]. Oxford: Butterworth-Heinemann, 
1994. 
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UNIX 哲学 QD) 
小 就 是 美 


英 语 Smallis beautiful 





AAA 软件 规模 越 小 越美 丽 


软件 规模 越 小 越美 丽 。 这 里 的 美丽 指 “ 价 值 高 ”。 

规模 小 的 软件 简单 、 易 用 ， 远 远 优 于 规模 大 的 软件 。 

因此 ,我们 在 开发 软件 时 应 将 软件 规模 控制 在 较 小 的 范围 。 维 护 软 
件 时 亦 是 如 此 。 








EUEA 汪 规模 较 小 的 软件 比较 好 用 
规模 较 小 的 软件 有 以 下 优点 。 


e 易于 理解 
规模 较 小 的 软件 专注 于 处 理 一 项 工作 ， 所 以 代码 相对 简单 。 这 种 
软件 只 包含 最 低 限 度 的 算法 ， 所 有 代码 都 为 其 工作 目标 服务 。 


e 容易 维护 
软件 规模 小 ， 代 码 的 可 读 性 就 比较 高 。 代 码 的 可 读 性 高 了 ， 代 码 
维护 就 会 变 得 简单 ， 因 为 理解 代码 是 维护 的 第 一 步 。 
充分 理解 代码 虽然 是 维护 的 大 前 提 ， 但 在 实际 工作 中 人 们 往往 忽 


视 这 一 点 。 
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e 给 计算 机 资源 带 来 的 负担 较 小 

在 软件 规模 较 小 的 情况 下 ， 运 行 只 会 占用 很 少 的 内 存 。 于 是 ， 内 
存 分 配 变 得 简单 ， 交 换 与 分 页 的 工作 也 相应 减少 ， 性 能 因此 而 得 
到 提升 。 

另外 ， 硬盘 占 用 量 也 会 变 少 。 


用 一 个 词 总 结 就 是 “ 轻 量 ”。 


e 便于 同 其 他 软件 组 合 
软件 体积 小 ， 其 工作 内 容 和 接口 也 一 定 不 会 复杂 。 这 方便 软件 与 
其 他 软件 自由 组 合 ， 从 而 灵活 应 对 需求 的 变化 。 


规模 较 大 的 软件 存在 以 下 问题 。 


e 代码 复杂 ， 令 人 难以 理解 
代码 规模 越 大 就 越 难 控制 。 规 模 巨 大 的 代码 超越 了 人 类 的 理解 能 
力 ， 就 连 编 写 代 码 的 程序 员 有 时 也 会 忘记 一 些 内 容 ， 比 如 哪个 函 
数 放 在 了 哪个 模块 、 哪 个 地 方 相互 引用 了 变量 、 某 个 变量 的 目的 
是 什么 ， 等 等 。 
这 样 的 代码 很 难 进行 调试 。 


。 无 法 应 对 例外 情况 
规模 较 大 的 软件 自身 就 是 一 个 独立 的 世界 。 这 种 软件 通常 会 备 齐 
用 户 需要 的 所 有 功能 。 
然而 谁 都 无 法 预测 未 来 ， 需 求 是 会 发 生变 化 的 。 单 独 一 款 软件 不 
可 能 应 对 所 有 的 例外 情况 。 


不 论 开发 还 是 维护 ， 软 件 都 要 保持 较 小 的 
规模 


在 写 代 码 时 ， 从 简单 的 地 方 开始 写 起 ， 证 软件 保持 在 一 个 较 小 的 
规模 。 
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在 设计 软件 时 ， 要 控制 软件 的 规模 ， 让 软件 专注 于 一 项 工作 。 功 能 
不 足 的 问题 可 以 通过 与 其 他 软件 协作 来 解决 。 

要 想 让 软件 保持 在 较 小 的 规模 ， 就 要 充分 理解 需要 解决 的 问题 ， 
为 在 没有 完全 理解 问题 的 时 候 ， 我 们 常会 想 一 些 复杂 的 解决 方案 ,使 软 
件 规模 变 大 。 体 积 巨大 的 软件 中 充斥 着 与 原本 目的 无 关 的 代码 。 
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UNIX 哲学 @) 


工作 唯一 


英 语 Make each program do one thing well 





一 个 软件 只 负责 一 项 工作 


每 个 软件 只 负责 做 好 一 项 工作 。 

在 自己 的 生命 周期 内 专注 于 做 好 一 项 工作 的 软件 才 是 真正 的 好 软 
件 。 这 种 软件 在 完成 自己 的 工作 后 会 立刻 退场 ， 为 负责 下 一 项 工作 的 软 
件 让 路 。 

假设 有 一 个 用 于 显示 目录 内 容 的 命令 。 我 们 不 能 为 了 美化 显示 结果 
而 给 这 个 命令 添加 调整 输出 格式 的 功能 。 这 个 命令 只 负责 显示 目录 内 
容 。 至 于 美化 显示 结果 ， 我 们 应 该 另外 创建 一 个 命令 来 完成 ， 然 后 将 两 
个 命令 组 合 起 来 使 用 。 




















加 让 软件 交 得 纯 粒 


软件 只 负责 做 好 一 项 工作 ， 这 样 可 以 消除 软件 自 号 多 余 的 代码 。 多 
余 的 代码 会 拖 慢 软件 的 运行 速度 ， 还 会 提升 代码 的 复杂 度 ， 对 添加 功能 
等 后 期 维护 工作 造成 影响 。 

软件 只 负责 做 好 一 项 工作 还 能 帮助 我 们 抓 住 该 工作 的 本 质 。 如 果 
写 不 出 这 种 只 做 好 一 项 工作 的 软件 ， 就 证 明 我 们 对 问题 的 理解 还 不 够 
透彻 。 

只 负责 做 好 一 项 工作 的 软件 便于 在 其 他 软件 中 重复 使 用 。 我 们 往往 
对 重复 使 用 大 规模 软件 采取 谨慎 的 态度 ， 而 对 于 这 种 只 做 一 项 工作 的 软 
件 ， 我 们 就 不 需要 有 所 顾虑 了 。 
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二 专注 于 一 项 工作 


我 们 要 让 一 个 软件 只 负责 一 项 工作 。 

在 处 理 规模 较 大 的 问题 时 ， 先 将 大 问题 分 割 成 小 问题 ， 然 后 开发 解 
决 各 个 小 问题 的 小 软件 。 要 让 这 些小 软件 只 专注 于 一 项 工作 。 这 样 一 
来 ， 原 本 规模 较 大 的 问题 也 能 一 步 一 步 得 到 解决 。 

当 某 一 问题 又 延伸 出 其 他 问题 时 ， 我 们 要 再 开发 一 个 专注 于 另 一 项 
工作 的 软件 ， 然 后 组 合 使 用 该 软件 与 现 有 软件 ， 以 此 来 解决 整个 问题 。 
不 在 原 软件 上 直接 添加 功能 是 为 了 避免 出 现 面条 式 代码 。 面 条 式 代码 党 
在 规模 巨大 的 软件 中 出 现 。 

编写 出 专注 于 一 项 工作 的 代码 后 ， 要 时 刻 提醒 自己 不 去 添加 功能 和 
选项 。 抵 御 “ 多 功能 主义 ”的 诱惑 比 我 们 想象 的 要 难 。 一 旦 经 不 住 诱 
惑 ， 我 们 的 软件 就 会 一 点 一 点 偏离 原本 的 目标 。 因 此 ， 我 们 要 时 常 问 自 
己 ， 这 些 代 码 是 否 真 的 有 用 ， 是 否 偏 离 了 软件 的 本 质 。 
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UNIX 哲学 @) 


尽早 创建 原型 


英 语 Build a prototype as soon as possible 





尽早 着 手 创建 原型 


要 尽早 创建 出 软件 的 原型 。 

要 想 知 道 一 个 点 子 是 否 可 行 ， 是 否 能 变 成 看 得 见 摸 得 着 的 产品 ， 最 
快 的 方法 就 是 亲手 试 着 做 一 下 。 这 个 试 着 做 出 来 的 东西 就 是 原型 。 

等 待 完 整 的 功能 说 明 书 只 会 浪费 时 间 。 通 过 原型 进行 学 习 还 能 加 大 
开发 的 动力 。 











ELEA 不 经 历 失 败 就 做 不 出 好 软件 








没有 人 能 避免 失败 ， 没 有 人 能 每 次 都 得 到 正确 的 结果 。 软 件 开 发 也 
一 样 ， 我 们 不 可 能 一 上 来 就 编写 出 完美 无 缺 的 软件 。 对 软件 而 言 ， 持 续 
的 改良 必 不 可 少 。 我 们 只 有 经 过 不 断 摸索 ， 对 软件 进行 无 数 次 修改 ， 才 
能 做 出 一 款 优 秀 的 软件 。 

另外 ,在 未 创建 原型 的 阶段 ， 所 有 点 子 都 逃 不 出 “这 里 应 该 这 样 运 
作 ” 这 种 腾 测 的 圈子 。 大 部 分 人 无 法 在 这 一 阶段 理解 设计 构想 ,结果 就 
出 现 了 一 个 人 一 种 理解 的 现象 。 但 是 ,项目 要 想 向 前 推进 ， 成 员 的 理解 
必须 一 致 。 这 时 ， 原 型 作为 一 个 看 得 见 摸 得 着 的 标志 物 ， 有 助 于 使 所 有 
成 员 的 想法 实现 统一 。 
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哉 Ai 习 借助 原型 提高 可 靠 度 





我 们 要 尽早 创建 原型 ， 缩 短发 布 周期 。 
原型 创建 得 越 早 ， 产 品 的 发 布 也 就 越 早 。 创 建 原 型 能 获得 以 下 
好 处 。 








e 提早 发 现 前 提 性 质 的 错误 

项 目 初期 需要 确定 设计 方针 ， 我 们 必须 尽早 判断 方针 的 正 误 。 创 
建 原 型 能 帮助 我 们 提早 发 现 前 提 性 质 的 错误 ， 将 损失 控制 到 最 
小 ， 从 而 避免 到 发 布 时 才 发 现 问 题 。 


e 减少 需求 不 完备 导致 的 返工 
原型 带 来 的 反馈 可 以 减少 需求 不 完备 导致 的 返工 。 用 户 见 到 原型 
后 如 果 给 出 积极 的 反应 ， 我 们 就 可 以 确信 需求 没有 错误 。 
有 时 候 用 户 会 指出 不 满 的 地 方 ， 这 些 意见 是 我 们 应 该 加 以 重视 的 
宝贵 信息 。 与 其 在 开发 完成 后 被 大 量 用 户 诉 病 ， 不 如 在 正式 开发 
之 前 接受 少数 用 户 的 批评 ， 未 雨 绸 绢 。 


e 能 提早 开始 排查 错误 

根据 原型 带 来 的 反馈 ， 我 们 可 以 提早 开始 排查 错误 。 这 项 工作 开 
始 得 越 早 ， 我 们 就 能 越 早 完成 高 质量 的 最 终 产 品 。 随 着 开发 的 不 
断 推 进 ， 有 问题 的 算法 、 不 一 致 的 时 间 点 和 难 懂 的 用 户 接口 等 问 
题 会 陆续 暴露 出 来 。 如 果 存 在 原型 ， 我 们 就 可 以 提早 对 这 些 问题 
进行 排查 ， 在 不 断 摸索 的 过 程 中 提高 产品 的 质量 。 


E33 四 第 三 系统 


任何 系统 都 有 一 个 改良 的 过 程 ， 都 会 按照 “第 一 系统 ”“ 第 二 系 
统 ”“ 第 三 系统 ”的 顺序 发 布 。 








e@ 第 一 系统 : 性 能 良好 ， 但 欠缺 一 部 分 必要 的 功能 


1 


@ 第 二 系统 : 天 平 倒 向 另 一 边 ， 在 牺牲 性 能 的 前 提 下 添加 了 很 多 功能 
。@ 第 三 系统 : 性 能 与 功能 之 间 取得 了 恰当 的 平衡 。 该 系统 保留 了 真 
正 有 用 的 功能 ， 我 们 能 够 用 适量 的 资源 完成 尽 可 能 多 的 工作 


我 们 在 开发 系统 时 应 以 第 三 系统 为 目标 。 

那么 ， 怎 样 才能 开发 出 第 三 系统 呢 ? 

答案 是 先 做 出 前 两 个 系统 。 除 此 之 外 别 无 他 法 。 再 怎么 努力 跳 过 前 
面 的 步骤， 到 头 来 也 只 是 多 做 了 几 个 第 一 系统 和 第 二 系统 ， 还 不 如 按照 
顺序 每 种 系统 只 做 一 个 。 
虽然 不 能 跳 过 第 一 系统 和 第 二 系统 ， 但 我 们 可 以 缩短 第 一 系统 到 第 
三 系统 的 周期 。 具 体 方法 就 是 使 用 原型 。 原 型 是 一 种 手段 ， 它 的 目的 是 
实现 第 三 系统 。 
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UNIX 哲学 由 


可 移植 性 优先 于 效率 


英 语 Choose portability over efficiency 





LEA 可 移植 性 优先 于 效率 








软件 设计 由 一 系列 选择 组 成 。 其 中 让 人 为 难 的 是 可 移植 性 和 开发 效 
率 这 一 对 互 斥 选项 。 这 里 我 们 应 该 优先 选择 可 移植 性 。 

可 移植 性 的 评价 标准 是 软件 在 配合 其 他 平台 进行 修改 时 所 需 成 本 的 
多 少 。 

重视 可 移植 性 有 助 于 软件 在 诸多 平台 上 运行 ， 延 长 软件 的 使 用 


寿命 。 




















维持 软件 的 价值 


衡量 软件 是 否 成 功 的 标准 之 一 是 软件 能 在 多 少 种 平台 上 运行 。 

当 软 件 依赖 于 特定 的 硬件 时 ， 软 件 就 只 能 在 该 硬件 有 竞争 力 的 时 期 
保持 价值 。 一 旦 硬件 失去 竞争 力 ， 软 件 的 价值 就 会 下 降 。 我 们 要 想 维持 
软件 价值 ， 就 需要 将 软件 移植 到 其 他 硬件 上 。 这 一 阶段 如 果 耗 时 过 长 ， 
就 会 给 业务 带 来 致命 的 打击 。 

开发 时 将 重点 放 在 提升 可 移植 性 上 的 软件 能 以 较 少 的 成 本 移植 到 新 
硬件 上 。 移 植 所 花 时 间 也 比较 短 ， 因 此 我 们 可 以 用 节省 下 来 的 时 间 开 发 
新 功能 。 

为 了 提升 可 移植 性 ， 我 们 可 以 考虑 适当 降低 开发 效率 ， 多 投入 一 些 
劳力 。 可 移植 性 带 来 的 回报 将 十 分 丰厚 。 
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二 编写 不 依赖 于 硬件 的 代码 


在 设计 软件 时 要 重视 可 移植 性 。 

为 了 提高 可 移植 性 ， 我 们 在 设计 软件 时 要 将 依赖 于 硬件 的 部 分 和 不 
依赖 于 硬件 的 部 分 分 离 。 不 依赖 于 硬件 的 部 分 应 按照 便于 重复 使 用 的 单 
位 实现 模块 化 。 

为 了 提高 可 移植 性 ， 代 码 优化 〈 性 能 调 优 ) 方面 所 花 时 间 应 尽量 缩 
短 。 因 为 一 旦 深入 优化 ， 就 需要 用 到 硬件 的 特殊 能 力 ， 这 显然 会 对 软件 
的 可 移植 性 造成 影响 。 可 移植 性 优先 于 优化 。 只 要 软件 拥有 良好 的 可 移 
植 性 ， 就 算 暂 时 损失 一 些 运 行 速度 ,我们 也 可 以 等 更 加 先进 的 硬件 问世 
后 ,使 用 新 的 硬件 来 解决 速度 问题 。 
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UNIX 哲学 @) 
文本 数据 
英 语 Storenumerical datain flatASCII files 


中 文 将 数值 数据 保存 在 ASCI 平 面 文件 内 





1 文本 文件 优 于 二 进 制 文件 


把 数据 保存 在 文本 文件 中 ， 不 要 采用 二 进 制 格式 的 数据 文件 。 

数据 是 在 移动 、 交 换 和 被 诸多 软件 使 用 的 过 程 中 不 断 提高 价值 的 。 
因此 ， 数 据 也 要 具备 良好 的 可 移植 性 。 使 数据 具备 可 移植 性 的 方法 就 是 
将 数据 保存 在 文本 文件 中 。 

不 论 对 用 户 而 言 还 是 对 程序 员 而 言 ， 在 大 多 数 情 况 下 ， 文 本 文件 要 
优 于 二 进 制 文件 。 



























































eaEA 少 文 本 文件 是 万 能 区 
文本 文件 有 以 下 优势 。 


@ 文本 是 最 普遍 的 、 可 移植 性 最 强 的 格式 。 文 本 格式 的 数据 文件 比 
代码 轻便 ， 因 此 它 的 可 移植 性 比 代 码 有 要强 

@ 方便 人 们 随时 查看 数据 。 另 外 ， 文 本 文件 能 够 通过 普通 的 文本 编 
辑 器 阅览 ， 便 于 修改 ， 也 便于 在 开发 中 调试 

@ 文本 格式 便于 工具 和 命令 调用 ， 不 需要 像 二 进 制 格式 那样 先 转换 
成 其 他 格式 


文本 文件 确实 比 二 进 制 文件 元 长， 但 在 大 多 数 情况 下 ， 二 者 运行 效 
率 的 差距 小 到 可 以 忽略 不 计 。 
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[3A 对 标准 文本 文件 


我 们 要 把 数据 保存 在 文本 文件 里 。 

设计 的 软件 要 可 以 输入 输出 文本 文件 ， 要 便于 和 其 他 软件 进行 
协作 。 

文本 文件 应 选用 不 受 语言 和 操作 系统 限制 的 标准 格式 ( CSV、XML 
等 ) 这 样 可 以 提高 软件 与 其 他 软件 的 连接 性 。 
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UNIX 哲学 (@@) 


充分 利用 软件 的 杠杆 效应 


英 语 Use software leverage to your advantage 





通过 软件 的 杠杆 效应 增 大 力 


杠杆 是 由 硬 棒 和 支点 组 成 的 一 种 可 以 增 大 力 的 装置 。 

在 杠杆 的 一 端 ( 施 力 点 ) 施加 力 后 ， 男 一 端 (作用 点 ) 会 产生 反方 
向 的 力 。 当 支点 位 于 硬 棒 中 央 时 ， 施 加 的 力 与 作用 力 的 关系 为 1 比 1。 
将 支点 向 作用 点 移动 后 ， 作 用 点 产生 的 力 将 大 于 我 们 施加 的 力 ， 这 就 是 
杠杆 效应 。 

将 软件 用 作 杠 杆 ， 就 可 以 使 自己 的 力 增 大 多 倍 。 要 想 实现 杠杆 效 
应 ， 就 需要 知道 如 何 让 支点 接近 作用 点 。 放 到 软件 领域 来 说 ， 就 是 想 办 
法 重复 使 用 既 有 软件 ， 将 各 个 软件 组 合 起 来 使 用 。 

个 体 的 力 是 有 限 的 。 不 过 ， 将 多 个 个 体 的 力 聚 集 起 来 ， 然 后 加 上 村 
杆 效应 ， 力 就 能 增 大 很 多 倍 。 









































IAA 汪 用 较 少 的 劳力 获得 巨大 的 成 果 





一 次 性 编写 大 量 代 码 的 最 好 方法 是 借用 现成 的 代码 。 

所 谓 借用 代码 ， 就 是 把 其 他 软件 的 模块 、 设 置 文件 或 软件 本 身 拿 到 
自己 的 软件 中 使 用 。 有 名 格言 是 这 么 说 的 : "好 的 程序 员 能 写 出 好 的 代 
码 ， 伟 大 的 程序 员 能 借 来 好 的 代码 。 

将 前 人 的 努力 成 果 融 入 自己 的 工作 之 中 ， 能 够 大 幅 提高 自身 代码 的 
可 用 性 。 

作为 被 使 用 的 一 方 ， 这 些 现 有 软件 通过 在 更 多 的 软件 中 发 光 发 热 ， 
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可 以 使 自身 存在 的 价值 得 到 提升 。 而 使 用 现 有 软件 的 软件 ， 因 为 投资 减 
少 ， 所 以 能 获得 更 多 的 收入 。 
总 而 言 之 ,我 们 可 以 将 杠杆 效应 应 用 到 软件 工作 中 。 





二 将 手动 作业 自动 化 





不 要 编写 充斥 着 各 种 功能 的 大 型 软件 ， 而 要 编写 多 个 功能 单一 、 价 
值 单一 的 小 型 软件 。 然 后 通过 胶水 语言 将 这 些小 型 软件 连接 起 来 ， 共 同 
完成 一 项 大 任务 。 

将 手动 作业 自动 化 是 有 效 利用 软件 杠杆 效应 的 一 个 典型 示例 。 对 于 
某 些 工作 ， 我 们 有 时 会 不 自觉 地 手动 完成 。 但 计算 机 能 完成 的 工作 由 人 
来 做 就 是 浪费 时 间 。 我 们 要 养 成 将 手动 作业 自动 化 的 习惯 ， 提 升 操作 的 
正确 性 和 生产 效率 。 
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UNIX 哲学 @) 


活用 shell 脚 本 


英 语 Use shell scripts to increase leverage 


and portability 


中 文 利用 shell 脚 本 加 大 杠杆 效应 ， 提 高 
软件 的 可 移植 性 





通过 shell 脚本 进行 连接 


我 们 可 以 利用 shell 脚本 加 大 杠杆 效应 ， 提 高 软件 的 可 移植 性 。 








e 杠杆 效应 
为 了 最 大 限度 利用 软件 的 杠杆 效应 ， 我 们 需要 有 效 使 用 shell 脚 
本 。 也 就 是 说 ， 用 shell 脚本 将 软件 与 其 他 软件 或 命令 连接 起 来 。 


e 可 移植 性 
为 了 保证 软件 的 杠杆 效应 ， 我 们 要 使 用 shell 脚本 提高 可 移植 性 。 
shell 脚本 属于 解释 型 语言 ， 不 需要 编译 成 平台 专用 的 二 进 制 文 
件 ， 所 以 与 编译 型 语言 相 比 ，shell 脚本 在 提高 软件 可 移植 性 方面 
效果 更 好 。 


EU 加 大 杠杆 效应 





shell 脚本 能 发 挥 巨大 的 杠杆 效应 。 

shell 脚本 中 使 用 的 命令 不 需要 我 们 亲自 编写 ， 直 接 使 用 他 人 的 成 果 
即 可 。 我 们 可 以 将 这 些 命令 添加 到 shell 脚本 中 ， 从 而 获得 枉 杆 效应 ， 
实现 自己 的 目的 。 
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另外 ，shell 脚本 有 着 很 高 的 可 移植 性 。 能 轻易 从 一 个 平台 移植 到 另 
一 个 平台 的 软件 往往 会 被 更 多 的 人 使 用 。 软 件 的 用 户 越 多 ， 其 杠杆 效应 
就 越 明显 。 











ly 二 将 shell 脚本 用 作 胶水 语言 


将 shell 脚本 用 作 胶 水 语言 。 用 shell 脚本 将 小 型 软件 连接 起 来 ， 共 
同 完 成 一 项 大 工程 。 
我 们 要 抵挡 住 诱惑 ， 不 把 自己 熟悉 的 编译 型 语言 用 作 胶 水 语言 。 使 
用 编译 型 语言 会 影响 软件 的 可 移植 性 ， 编 译 过 程 还 会 消耗 额外 的 时 间 ， 
打 乱 编程 的 节奏 。 况 且 ，shell 脚本 与 编译 型 语言 在 执行 速度 上 本 就 相差 
无 几 。 


E53 后 由 胶水 语言 


胶水 语言 的 英文 是 glue language。glue 是 胶水 的 意思 ， 胶 水 语言 就 
是 连接 软件 与 软件 的 语言 。 

最 常用 的 胶水 语言 是 shell 脚本 。 

shell 脚本 又 称 为 命令 行 解 释 器 ， 它 有 简单 的 控制 结构 。 利 用 shell 
脚本 可 以 使 命令 与 命令 、 软 件 与 软件 相 结合 ， 实 现 流 程 作业 ， 或 者 完成 
特定 的 处 理 。 
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UNIX 哲学 @ 


避 开 交互 式 用 户 接口 


< 


莫 语 Avoid captive user interfaces 





是 什么 交互 式 用 户 接口 











交互 式 用 户 接口 又 称 为 拥 绑 型 用 户 接口 ， 是 软件 位 于 命令 解释 器 的 
上 位 与 用 户 进行 对 话 的 一 种 模式 。 

这 种 软件 从 启动 到 运行 结束 ， 用 户 都 无 法 与 命令 解释 器 对 话 。 用 户 
被 捆绑 在 该 软件 的 用 户 接 口内 部 ， 在 解除 捆绑 之 前 无 法 脱身 。 














交互 式 用 户 接口 会 束缚 用 户 、 机 器 及 软件 


交互 式 用 户 接口 会 产生 以 下 问题 。 








e 程序 员 需 要 记 住 软件 各 自 的 对 话 方法 
在 UNIX 中， 程序 员 原 本 只 要 记 住 命令 解释 器 的 使 用 方法 即 可 。 
但 如 果 使 用 了 交互 式 用 户 接口 ， 程 序 员 还 必须 记 住 软件 各 自 的 对 
话 方法 。 


e 软件 之 间 无 法 对 话 
用 户 接口 以 人 为 基准 进行 了 优化 , shell 脚本 失去 了 杠杆 效应 。 


e 等 待 时间 变 长 
等 待人 类 的 输入 成 了 机 器 的 瓶颈 ， 机 器 无 法 充分 发 挥 性 能 。 
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。 输入 部 分 负责 解析 的 代码 变 得 膨胀 和 不 清晰 
如 果 将 输入 的 多 样 性 和 输出 的 可 读 性 纳入 考虑 范围 ， 解 析 输 入 字 
符 事 的 代码 必然 会 发 生 膨 胀 。 


e 产生 “大 就 是 美 ” 的 错误 引导 

交互 式 用 户 接口 用 菜单 进行 功能 选择 ， 这 正 是 多 功能 主义 蔓延 的 
契机 。 此 外 ， 交 互 式 用 户 接口 无 法 与 其 他 软件 协作 ， 所 以 只 能 让 
自己 变 得 越 来 越 大 。 


li 蚁 将 控制 权 还 给 命令 解释 器 


在 设计 软件 时 要 避 开 交互 式 用 户 接口 。 

和 软件 进行 对 话 的 应 该 是 软件 ， 而 不 是 人 。 软 件 完 成 一 项 工作 后 ， 
应 当 立 刻 将 控制 权 还 给 命令 解释 器 。 

当然 ， 为 初学 者 准备 的 交互 式 用 户 接口 在 很 多 情况 下 有 着 很 好 的 效 
果 。 但 随 着 用 户 的 不 断 学 习 ， 交 互 式 用 户 接口 会 变 得 宛 长 无 用 ， 所 以 我 
们 要 准备 两 种 用 户 接口 ， 一 种 面向 初学 者 ， 一 种 面向 老 用 户 。 
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UNIX 哲学 9) 


过 滤器 化 


英 语 Make every program a filter 


中 文 让 所 有 软件 都 成 为 过 滤 需 





CA 把 软件 设计 成 过 滤器 


我 们 要 把 所 有 软件 都 设计 成 过 滤器 。 

所 谓 过 滤器 ， 就 是 将 输入 流 作为 数据 接收 后 ， 经 过 某 种 加 工 ， 再 将 
数据 以 流 的 形式 输出 。 

软件 的 本 质 是 处 理 数 据 ， 而 不 是 生成 数据 。 为 了 最 大 限度 发 挥 软件 
的 能 力 ， 所 有 软件 都 应 该 设计 成 过 滤器 。 








ze 软件 的 意义 就 是 输入 输出 





软件 是 人 写 出 来 的 ， 所 有 软件 都 是 处 理 数据 的 过 滤器 。 

比如 实时 收集 数据 的 软件 就 是 过 滤器 。 软 件 要 定期 取样 ， 收 集 数 
据 ， 这 就 是 输入 流 。 然 后 ， 软 件 会 从 数据 中 抽取 合适 的 部 分 ， 以 流 的 形 
式 输 出 。 

再 比如 ,拥有 GUI 的 软件 也 是 过 滤器 。GUI 将 鼠标 和 键盘 按键 视 为 
事件 来 处 理 。 这 些 事件 会 发 送 给 窗口 系统 控制 下 的 某 个 软件 ， 这 就 是 输 
入 流 。 软 件 对 事件 有 所 反应 ， 更 新 显示 器 的 显示 内 容 ， 这 就 是 输出 流 。 

计算 机 是 高 效 收 集 、 过 滤 数据 的 道具 。 我 们 设计 的 软件 只 要 能 很 好 
地 完成 这 两 项 工作 即 可 。 
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月 





过 A 恒 使 用 标准 输入 输出 


要 将 软件 设计 成 处 理 数 据 的 过 滤 带 。 
特别 是 在 设计 可 以 通过 命令 行 启动 的 软件 时 ,一 定 要 正确 设计 成 使 














标准 输入 输出 。 数 据 输入 要 使 用 标准 输入 ， 数 据 输出 要 使 用 标准 输 


出 。 男 外 ,错误 信息 要 用 标准 错误 输出 。 


这 种 设计 方式 可 以 保证 软件 之 间 能 够 进行 连接 ( 可 连接 性 )。 这 样 





一 来 ， 软 件 之 间 就 能 相互 组 合 ， 共 同 完成 一 项 由 单独 的 软件 无 法 完成 的 
大 型 工作 了 。 


UNIX 哲学 中 的 准则 











UNIX 哲学 中 有 十 条 值得 我 们 重视 的 准则 。 


e 允许 用 户 自 定义 环境 

让 用 户 可 以 按照 自己 的 喜好 调整 环境 。 

UNIX 的 用 户 喜欢 根据 自己 的 想法 修改 环境 。 因 此 ， 许 多 UNIX 
的 软件 在 使 用 风格 的 选择 上 给 了 用 户 非常 大 的 自由 度 。 

用 户 最 初 会 因 UNIX 的 灵活 性 而 感到 迷 荡 ,被 大 量 的 选项 吓 到 。 但 
时 间 一 长 ， 用 户 就 会 花 时 间 去 学 习 这 些 选项 ， 并 试 着 使 用 它们 。 
当 适 应 到 一 定 程 度 后 ， 用 户 便 很 难 再 用 回 其 他 操作 系统 了 。 当 花 
费 在 UNIX 上 的 时 间 累 积 到 一 个 国 值 时 ， 用 户 就 会 改 掉 系 统 中 不 
顺眼 的 部 分 。 

这 种 情况 并 非 只 出 现在 操作 系统 中 。 当 软件 具有 足够 的 灵活 性 
时 ， 用 户 会 为 了 更 好 地 使 用 软件 而 花费 时 间 去 学 习 使 用 方法 。 而 
且 ， 用 户 越 习 惯 自己 调整 的 环境 ， 就 越 难 回 到 那些 无 法 调整 的 环 
境 中 。 


e 让 内 核 小 而 轻巧 
操作 系统 的 内 核 要 小 而 轻巧 。 
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在 UNIX 的 历史 中 ， 关 于 操作 系统 的 内 核 中 要 不 要 包含 应 用 程序 
这 一 问题 ， 人 们 讨论 过 很 多 次 。 因 为 在 内 核 中 加 入 应 用 程序 可 以 
在 应 用 程序 的 执行 过 程 中 减少 上 下 文 切换 的 次 数 ， 提 高 性 能 。 
然而 ，UNIX 拒绝 了 内 核 肥 大 化 ， 选 择 了 让 内 核 小 而 轻巧 的 方 
案 。 原 因 有 以 下 两 点 。 

一 是 如 果 应 用 程序 包含 在 内 核 里 ， 普 通 程序 员 就 无 法 对 其 进行 修 
改 。 只 能 由 负责 内 核 的 程序 员 进 行 维护 的 应 用 程序 无 法 实现 进化 。 
另 一 个 原因 是 当 应 用 程序 出 现 故障 时 ， 内 核 很 可 能 受到 影响 。 在 
最 坏 的 情况 下 ， 使 用 该 应 用 程序 会 导致 意外 停机 。 


使 用 小 写字 母 

命名 时 要 使 用 小 写字 母 ， 而 且 名 称 要 短 。 

使 用 小 写字 母 是 UNIX 的 传统 。 命 令 名 和 文件 名 基本 都 使 用 小 写 
字母 。 另 外 ， 名 称 要 尽量 短小 简洁 。 

名 称 使 用 小 写字 母 的 原因 有 以 下 几 点 。 

首先 是 对 眼睛 好 。 小 写字 母 更 适合 我 们 长 时 间 阅 读 。 

其 次 ， 小 写字 母 的 外 观 富 于 变化 ， 所 以 小 写字 母 有 较 高 的 识别 
度 ， 更 易于 阅读 。 

最 后 ， 能 使 大 写字 母 更 加 突出 。 如 果 周 围 的 文件 名 都 是 小 写字 
母 ， 这 时 我 们 将 一 个 文件 命名 为 “README”， 这 个 文件 就 会 非 
常 醒 目 。 另 外 ， 在 排序 时 ， 大 写字 母 会 排 在 小 写字 母 的 前 面 ， 这 
也 让 大 写字 母 变 得 更 加 突出 。 

使 用 较 短 的 名 称 是 为 了 将 命令 控制 在 一 行 以 内 。 特 别 是 用 管道 操 
作 符 连接 命令 时 ， 将 命令 缩短 到 一 行 会 带 来 许多 方便 。 


保护 森林 

尽量 不 用 纸 ， 保 护 森 林 。 

UNIX 用 户 讨厌 纸 质 文档 ， 因 为 他 们 无 法 操作 纸 上 的 数据 。 印 刷 
在 纸 上 的 数据 既 不 能 排序 ， 又 不 能 移动 ， 也 不 能 筛选 、 变 形 和 修 
改 。 至 少 这 一 切 不 能 像 在 计算 机 上 一 样 轻松 实现 。 纸 上 的 数据 不 


能 保存 在 硬盘 里 供 我 们 随时 取出 使 用 ， 也 不 能 进行 搜索 ， 当 然 也 
不 能 通过 加 密 来 保护 重要 信息 。 

我 们 要 养 成 在 计算 机 中 保存 文本 文件 的 习惯 ， 并 学 会 使 用 强大 的 
工具 来 操作 它们 。 


沉默 是 金 

软件 应 极力 减少 显示 内 容 。 

UNIX 的 命令 在 需要 显示 详细 错误 信息 的 情况 下 也 会 保持 沉默 。 
用 惯 了 其 他 操作 系统 的 用 户 可 能 会 感到 不 适应 ， 可 一 旦 习惯 了 

UNIX， 就 会 深 说 其 好 处 。 

以 用 于 显示 文件 一 览 的 命令 为 例 ， 当 目录 中 不 存在 文件 时 ， 其 他 

操作 系统 会 显示 “没有 找到 文件 ”之 类 的 报告 ,而 UNIX 不 会 显 

示 任 何 信息 。 

软件 保持 沉默 ， 画 面 上 就 只 会 显示 有 意义 的 数据 ， 不 会 出 现 无 意 

义 的 信息 。 夫人 六 让 才 衣 的 信息 被 海 没 在 无 用 数据 的 大 海 之 

中 

另外 ， 保 持 沉默 还 有 利于 软件 之 间 相 互 结合 。UNIX 命令 发 挥 的 

是 过 滤器 的 作用 ， 它 通过 UNIX 的 管道 结构 与 其 他 过 滤器 相 结 

合 。 很 多 看 上 去 对 用 户 很 友好 的 信息 ， 往 往 会 成 为 阻碍 软件 间 相 

互 结 合 的 主要 因素 。 


并 行 思考 

所 谓 并 行 思考 就 是 让 CPU 尽 可 能 忙碌 。CPU 的 速度 非常 快 。 为 
了 最 大 限度 发 挥 CPU 的 能 力 ， 我 们 允许 CPU 与 周边 装置 或 人 类 
的 步调 不 一 致 ， 让 CPU 时 刻 处 于 忙碌 的 状态 。 

为 此 ,我 们 要 把 工作 分 割 成 多 个 部 分 同时 执行 。 大 部 分 工作 是 可 
以 分 割 成 多 个 部 分 的 。 几 个 部 分 同时 执行 能 提高 工作 效率 。 


部 件 联动 
部 分 的 总 和 大 于 整体 。 
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将 小 部 件 聚 集 起 来 组 成 一 个 大 规模 的 软件 要 比 单独 开发 一 个 大 规 
模 软 件 更 有 价值 。 

小 部 件 组 合 而 成 的 软件 具有 很 好 的 灵活 性 。 加 入 其 他 部 件 可 以 延 
长 软件 的 使 用 寿命 。 

而 拥有 多 个 功能 的 综合 型 软件 属于 大 规模 单 体型 软件 。 这 种 软件 
包含 多 余 的 功能 ， 而 且 无 法 只 针对 一 部 分 功能 进行 扩展 。 另 外 ， 
庞大 的 代码 量 使 这 类 软件 难以 维护 ， 执 行 时 需要 使 用 较 多 的 资源 
也 对 性 能 造成 了 不 好 的 影响 。 


完成 90% 的 目标 

我 们 要 以 完成 90% 的 目标 为 准则 。 

任何 事情 都 很 难 达 到 100% 完美 。 保 证 做 好 90% 的 工作 能 大 幅 提 
升 工作 效率 ， 性 价 比 很 高 。 要 以 满足 对 象 用 户 90% 的 要 求 为 目 
标 ， 剩 下 的 10% 保持 “用 户 自己 想 办 法 解决 ”的 状态 。 

所 谓 完成 90% 的 目标 ， 就 是 故意 无 视 最 难 的 部 分 。 最 难 的 部 分 是 
所 有 问题 中 最 消耗 成 本 的 部 分 ， 也 是 最 花 时 间 、 最 难 编程 的 部 
分 。 忽 视 最 难 的 10%， 剩 下 的 问题 将 很 快 得 到 解决 。 


劣 就 是 优 

UNIX 重视 劣 等 功能 的 生存 能 力 。 该 操作 系统 体现 了 “ 劣 就 是 
优 ” 这 一 着 向 思维 。 

我 们 时 常 能 听 到 “UNIX 不 如 其 他 操作 系统 ”这 样 的 评价 。 
UNIX 受到 过 很 多 批评 ， 比 如 “用 户 接口 难 用 "”“ 太 简单 ， 不 像 
一 个 正经 的 操作 系统 ”等 。 然 而 ， 如 果 UNIX 真有 这 么 多 地 方 劣 于 
其 他 系统 ， 为 什么 那些 系统 没 能 经 得 起 历史 的 考验 生存 下 来 呢 ? 
UNIX 相信 “最 大 公约 数 ” 类 型 的 系统 能 生存 下 来 。“ 虽 不 高 级 
但 有 效率 ” 比 “ 高 质量 且 高 价 ” 的 系统 更 容易 让 人 们 接受 。 


层次 化 思维 
结构 要 有 层次 。 


UNIX 用 户 和 UNIX 程序 员 喜欢 将 事物 整理 成 层次 化 结构 。 
UNIX 文件 系统 使 用 的 目录 结构 是 最 早 的 层次 化 结构 。UNIX 的 
其 他 地 方 也 用 到 了 这 种 层次 化 思维 ， 比 如 进程 树 、 义 窗口 系统 和 
网 络 服务 等 ， 都 取得 了 成 功 。 

自然 界 的 秩序 是 符合 层次 化 结构 的 。UNIX 的 结构 以 自然 为 模 
型 ， 证 明了 层次 化 思维 是 一 种 非常 优秀 的 思维 方式 。 

层次 化 思维 本 身 确实 十 分 简单 。UNIX 的 所 有 方面 都 体现 了 这 一 
思维 方式 ， 因 为 这 个 简单 的 思维 方式 中 蕴含 着 巨大 的 意义 。 
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身上 缺点 太 多 固然 是 一 件 坏事 ， 
但 是 满 身 缺点 却 又 不 愿意 承认 ， 
那 就 更 不 好 了 。 


一 一 帕斯卡 


内 聚 度 
英 语 Cohesion 


别 名 模块 强度 





LEA 模块 要 “纯粹 ” 





内 聚 度 用 于 表示 模块 内 功能 的 纯粹 程度 ， 用 来 衡量 模块 的 强度 。 

内 聚 度 的 强度 分 为 七 个 等 级 。 等 级 越 高 的 模块 越 纯 粹 ， 强 度 也 越 
高 ， 质 量 也 越 好 。 

判断 内 聚 度 要 着 眼 于 模块 内 各 元 素 之 间 关 系 的 紧密 程度 。 下 面 笔者 
按照 等 级 由 低 到 高 ( 由 劣 到 优 ) 的 顺序 逐一 进行 说 明 。 


中 等 级 一 ”巧合 强度 

在 巧合 强度 模块 中 ， 各 元 素 之 间 并 不 存在 特别 的 关系 。“ 巧 合 ” 指 
事物 恰巧 一 致 。 

比如 模块 内 恰好 有 重复 的 命令 群 模式 ， 我 们 将 它 男 外 整合 成 一 个 模 
块 ， 这 个 模块 就 是 巧合 强度 模块 。 在 这 种 情况 下 ,我们 无 法 准确 命名 、 
定义 该 模块 的 功能 ， 因 为 模块 处 理 的 功能 各 不 相关 。 

我 们 可 结合 下 图 来 理解 巧合 强度 。 






















































































模块 B 模块 B 
处 理 a CALLA 
处 理 b : E 
: CALLA 
处 理 a : 
处 理 b 
: 模块 A 
处 理 a 
处 理 b bh 本 
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模块 A 中 的 处 理 a 和 处 理 b 没有 什么 特殊 的 关系 。 因为 这 种 
命令 群 模式 恰巧 在 模块 B 的 多 个 地 方 出 现 ， 所 以 我 们 将 其 整合 成 了 一 个 
模块 。 

模块 A 中 包含 了 很 多 没有 任何 关联 的 功能 。 对 该 模块 而 言 ， 模 块 的 
部 分 命令 发 生变 更 的 可 能 性 还 是 很 高 的 。 这 时 ， 如 果 模 块 B 要 调用 模块 
A， 而 模块 B 的 其 余部 分 (相同 部 分 之 外 的 部 分 ) 又 与 变更 的 内 容 毫 无 
关联 ， 那 么 调用 模块 A 将 是 一 种 很 危险 的 行为 。 如 此 一 来 ， 整 个 模块 设 
计 都 要 重新 修改 。 

另外 ， 在 巧合 强度 模块 中 ， 各 个 元 素 与 该 模块 内 其 他 元 素 的 关联 性 
较 弱 ， 这 就 表示 这 些 元 素 很 可 能 与 其 他 模块 中 的 元 素 具 有 和 较 强 的 关联 
性 。 因 此 ， 当 其 他 模块 发 生变 更 时 ， 巧 合 强度 模块 就 容易 受到 影响 ， 变 
得 难以 维护 。 

再 者 ， 无 法 准确 定义 模块 的 功能 就 意味 着 模块 的 功能 很 难 被 重复 
使 用 。 


等 级 二 逻辑 强度 

逻辑 强度 模块 指 抽象 地 整合 了 某 种 功能 的 模块 。 

所 谓 抽 象 地 整合 某 种 功能 ， 举 例 来 说 ， 就 是 把 所 有 的 输入 输出 操作 
整合 成 一 个 模块 ， 或 者 把 编辑 各 种 数据 的 功能 整合 成 一 个 模块 。 

这 种 模块 内 的 逻辑 会 根据 条 件 来 选择 不 同 的 执行 路 径 。 也 就 是 说 ， 
逻辑 强度 模块 包含 了 几 种 相互 关联 的 功能 ， 调 用 模块 会 识别 其 中 一 种 来 
执行 。 

所 以 ， 这 种 模块 被 调用 时 只 会 执行 其 中 一 部 分 命令 ， 不 会 执行 模块 
内 的 所 有 命令 。 模 块 内 部 命令 群 的 关联 性 会 变 弱 ， 模 块 强度 会 变 小 。 

另外 ,不 同 的 功能 只 能 使 用 同一 个 接口 〈 输 入 输出 参数 ) 与 调用 方 
模块 联系 。 因 此 ， 参 数 的 操作 方面 容易 出 现 编程 错误 。 

不 过 ， 逻 辑 强 度 模 块 也 有 好 的 一 面 。 

首先 ， 这 种 模块 包含 多 个 共同 的 功能 。 部 分 逻辑 可 以 实现 共享 。 
其 次 ， 相 关 功 能 整合 在 了 一 个 模块 内 ， 这 有 助 于 证 程序 员 的 思维 更 
加 集中 。 
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再 次 ,特定 数据 的 处 理 能 够 集 
中 强度 模块 有 着 良好 的 信息 隐蔽 性 。 
十 ， 我 们 只 要 对 这 一 个 模块 进行 修改 即 可 。 





LDL 
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(3 等 级 二 ”时 间 强 度 





P 在 一 个 模块 内 进行 。 也 就 是 说 ， 逻 
这 样 一 来 ， 当 该 部 分 数据 发 生变 更 
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间 


时 间 强 度 模块 由 在 特定 的 时 间 点 连续 执行 的 多 个 功能 整合 而 成 。 模 
块 内 各 功能 之 间 不 存在 很 强 的 关联 性 ， 它 们 只 是 在 特定 的 时 间 点 被 连续 





执行 而 已 。 
时 间 强 度 模 块 中 比较 有 代表 性 








的 是 “初始 处 理 模块 "。 在 软件 的 初 


始 处 理 中 ， 生 成 作业 空间 、 清 空 各 种 表 等 处 理 虽然 不 存在 很 强 的 关联 





性 ， 但 它们 都 会 在 软件 的 初始 处 理 





由 等 级 四 流程 强度 
流程 强度 模块 由 处 开 











统一 完成 。 





天 人 
初始 处 理 
生成 作业 空间 
清空 各 种 表 
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问题 时 所 需 的 全 部 或 部 分 功能 组 合 而 成 。 
这 些 功 能 按 顺序 执行 。 一 般 来 说 ， 流 程 强度 模块 














具有 时 间 强 度 模块 








的 特性 ， 但 由 于 流程 强度 模块 的 各 功能 之 间 具 有 流程 方面 的 关联 性 ， 所 
以 这 类 模块 的 内 聚 度 比 时 间 强 度 模 块 的 内 聚 度 要 高 。 
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流程 强度 模块 在 我 们 只 需 用 到 一 种 功能 时 无 法 使 用 。 要 想 只 使 用 这 
类 模块 中 的 一 种 功能 ， 就 必须 让 该 模块 实现 功能 选择 。 但 这 样 一 来 ， 模 
块 的 内 聚 度 就 会 降 至 逻辑 强度 。 

如 果 将 大 型 功能 的 一 部 分 流程 整合 成 一 个 模块 ， 那 么 这 个 模块 就 是 
流程 强度 模块 。 把 流程 图 的 部 分 内 容 模块 化 就 属于 这 种 情况 。 


流程 图 






































G) 等 级 五 ”通信 强度 
通信 强度 模块 基本 拥有 流程 强度 模块 的 特性 。 
与 流程 强度 的 模块 不 同 的 是 ， 这 种 模块 内 部 的 各 功能 之 间 会 进行 数 
据 的 传递 (通信 ) 或 引用 相同 的 数据 。 在 通信 强度 模块 中 ， 因 为 功能 在 
数据 上 存在 联系 ， 所 以 通信 强度 模块 的 内 聚 度 要 高 于 流程 强度 模块 的 内 
聚 度 。 
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(© 等 级 六 信息 强度 
言 息 强度 模块 由 处 理 特定 数据 结构 的 多 个 功能 组 成 。 
这 种 模块 的 基本 思想 是 同一 种 数据 结构 ( 信息 ) 尽量 由 同一 个 模块 
来 访问 。 这 样 一 来 ， 修 改 数据 所 带 来 的 影响 将 限制 在 相应 的 模块 内 ， 从 
言 息 隐藏 的 角度 来 说 有 一 定 的 好 处 。 





























接 入 点 
O 


接 入 点 
O 





接 入 点 
O 





逻辑 强度 模块 也 具有 信息 隐藏 的 特质 ， 只 不 过 在 接 人 点 的 数量 方面 
与 信息 强度 模块 有 所 不 同 。 
逻辑 强度 模块 只 有 一 个 接 和 点， 执行 的 功能 要 靠 参 数 来 选择 。 
而 信息 强度 模块 有 多 个 接 和 人 点 ， 各 接 和 人 点 执行 单一 的 固定 的 功能 。 
各 个 接 入 点 拥有 自己 的 参数 ， 因 此 这 类 模块 不 存在 逻辑 强度 模块 中 参数 
难以 处 理 的 缺点 。 
中 等 级 七 ”功能 强度 


在 功能 强度 模块 内 ， 所 有 命令 都 为 了 完成 一 项 工作 ( 功能 ) 而 相互 
关联 。 这 类 模块 是 纯粹 度 最 高 的 模块 。 



























































模块 A 


Matrix Add(x, y) { 























( 仅 有 和 珑 阵 加 法 的 相关 处 理 
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为 了 实现 一 个 功能 ， 所 有 命令 都 相互 关联 。 

在 这 种 情况 下 ， 仅 修改 一 部 分 命令 的 可 能 性 非常 小 。 即 便 要 进行 修 
改 ， 也 是 因为 使 用 该 模块 的 其 他 模块 都 出 现 了 相同 的 问题 。 

也 就 是 说 ， 功 能 强度 模块 可 以 将 修改 限制 在 该 模块 内 部 。 这 类 模块 
对 其 他 模块 的 影响 程度 比 其 他 强度 的 模块 要 小 。 

















zi 有 杂质 的 模块 很 脆弱 





代码 要 分 割 到 模块 中 进行 管理 。 

独立 性 对 分 割 好 的 模块 而 言 十 分 重要 。 提 高 模块 的 独立 性 有 助 于 减 
少 代码 的 复杂 度 ， 增 加 代码 的 可 靠 性 ， 对 代码 的 维护 也 有 帮助 。 

要 提高 独立 性 ， 就 得 让 各 个 模块 内 元 素 的 关联 性 达到 最 强 ， 同 时 让 
模块 与 模块 之 间 的 关联 性 减 到 最 弱 。 

内 聚 度 是 衡量 模块 内 各 元 素 关联 性 的 尺度 ， 是 评价 模块 自身 关联 性 
强 弱 的 标准 。 

内 聚 度 低 的 模块 有 一 些 典型 的 特征 ， 比 如 模块 会 处 理 一 些 不 相关 的 
工作 ， 或 者 模块 需要 处 理 的 工作 过 多 等 。 这 会 导致 以 下 问题 发 生 。 




















@ 代码 难以 理解 

@ 代码 难以 维护 

@ 代码 难以 重复 使 用 

@ 代码 脆弱 ， 容 易 受 修改 的 影响 











内 聚 度 高 的 模块 ， 其 内 部 各 元 素 间 有 很 强 的 关联 性 。 这 种 被 适当 细 
分 化 的 模块 会 专注 于 执行 特定 的 工作 。 这 能 带 来 以 下 好 处 。 


@ 使 代码 的 设计 更 加 明确 ， 更 容易 让 人 理解 
@ 代码 昂 于 维护 和 扩展 

@ 促进 代码 的 重复 使 用 

@ 促进 代码 之 间 的 低 耦 合 性 
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以 实现 高 内 聚 的 模块 为 目标 


为 了 提高 模块 的 独立 性 ， 我 们 要 尽量 实现 功能 强度 模块 。 

不 过 ， 从 可 以 将 特定 数据 的 处 理 控制 在 局 部 范围 这 一 点 来 看 ， 信 息 
强度 模块 也 有 很 高 的 实用 价值 。 虽 然 信息 强度 和 功能 强度 是 模块 非常 理 
想 的 状态 ,但 模块 并 不 是 非 要 达到 这 种 状态 不 可 。 在 实际 进行 模块 化 
时 ， 由 于 要 兼顾 各 种 情况 ， 我 们 有 时 也 需要 实现 其 他 强度 的 模块 。 

即便 迫不得已 需要 实现 某 种 强度 的 模块 ， 我 们 也 不 能 省 掉 讨 论 代 替 
方案 的 过 程 ， 否 则 会 给 整体 设计 带 来 不 好 的 影响 。 









































出 处 
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相关 图 书 
[1] Glenford J. Myers. Composite/structured design[M]. New York: Van 
Nostrand Reinhold, 1978. 
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耦合 度 


英 语 Coupling 





志恒 模块 间 应 “ 玻 远 ” 





耦合 度 是 衡量 模块 之 间 关 系 紧 密 程度 的 标准 。 耘 合 度 测 量 的 是 两 个 
模块 之 间 耦 合 的 松紧 程度 。 

耦合 度 分 为 六 个 等 级 。 等 级 越 高 (数字 越 大 )， 关 联 程度 就 越 弱 ， 
耦合 度 就 越 低 ， 模 块 质量 也 就 越 好 。 
耦合 度 的 判定 要 着 眼 于 模块 间 如 何 传递 数据 。 下面 笔 者 会 按照 等 级 
由 低 到 高 〈 由 劣 到 优 ) 的 顺序 逐一 进行 说 明 。 


山 等 级 一 内 容 耦 合 
内 容 耦 合 指 模块 与 其 他 模块 存在 共享 部 分 。 


模块 B 























模块 人 








直接 引用 其 他 模块 内 未 进行 外 部 声明 的 部 分 ， 或 者 与 其 他 模块 共享 
一 部 分 命令 的 情况 都 属于 内 容 耦 合 。 

内 容 耦 合 不 会 出 现在 使 用 高 级 语言 编写 的 模块 中 ， 但 常 在 使 用 汇编 
语言 编写 的 模块 里 出 现 。 
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在 内 容 耦 合 的 模式 下 ， 一 个 模块 的 修改 会 对 其 他 模块 造成 影响 。 修 
改 模块 时 兼顾 其 他 模块 是 一 项 非常 费力 的 工作 ， 所 以 在 内 容 耘 合 的 模式 
下 ， 修 改 操 作 很 可 能 会 引发 故障 。 


四 等 级 二 公共 耦合 
公共 耦合 指 在 公共 区 域内 定义 的 数据 由 多 个 模块 共同 使 用 。 
共 区 域内 定义 的 数据 就 是 全 局 变量 。 


共 耦 合 的 耦合 度 很 高 ， 害 处 有 很 多 。 








公 
公 


@ 公共 区 域 的 数据 不 会 出 现在 模块 间 的 接口 上 ， 这 使 得 代码 不 容易 


被 解读 

@ 因为 公共 区 域 的 数据 可 以 供 毫 无 关系 的 模块 使 用 ， 所 以 代码 的 安 
全 性 较 低 

@ 公共 耦合 的 模块 通过 公共 区 域 的 数据 与 许多 模块 发 生 关 联 ， 阻 碍 
了 代码 的 重复 使 用 











当 数 据 X 的 长 度 因 模 块 A 发 生 改变 时 ， 负 责 模块 A 的 程序 员 可 能 
不 知道 模块 C 也 在 使 用 数据 X。 负 责 模 块 A 的 程序 员 可 能 没有 想 过 修 


多 


1 
改 数据 X 会 给 模块 C 带 来 什么 样 的 影响 。 这 样 一 来 ， 模 块 C 很 可 能 出 


现 意 想 不 到 的 问题 。 

不 过 ， 公 共 耦 合 的 数据 可 以 被 其 他 模块 使 用 。 这 一 点 既是 公共 耘 合 
的 短处 ， 也 是 它 的 长 处 。 

如 果 避 开 公共 耦合 ， 模 块 之 间 传 递 数据 的 参数 必然 会 增多 。 传 递 数 
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据 的 参数 一 旦 增多 ， 我 们 就 很 难 正确 理解 每 一 个 参数 的 意义 了 。 创 建 模 
块 时 也 需要 花费 更 多 的 时 间 来 写 参数 。 

如 果 使 用 公共 耦合 ， 我 们 就 不 用 指定 参数 了 。 这 可 以 降低 创建 模块 
的 难度 ， 其 带 来 的 优势 甚至 能 弥补 前 面 所 说 的 短处 。 现 实 中 确实 有 不 少 
采用 公共 耦合 的 事例 。 

然而 ， 采 用 了 不 恰当 的 模块 设计 才 是 需要 大 量 参数 传递 数据 的 主要 
原因 。 通 过 重新 设计 模块 ， 再 次 审查 数据 的 位 置 ， 参 数 的 数量 大 多 能 够 
减少 。 


(3) 等 级 三 ”外 部 辜 合 


外 部 耦合 指 模块 间 共 享 外 部 声明 的 数据 。 
外 部 声明 的 定义 ， 举 例 来 说 就 是 public 声明 的 函数 。 









































模块 B 























外 部 声 B 








从 共享 数据 的 意义 上 讲 ， 外 部 耦合 与 公共 耦合 有 相似 之 处 。 不 过 ， 外 
部 耦合 只 外 部 声明 有 用 的 数据 ， 所 以 不 会 像 公共 耦合 那样 连 没 有 用 的 数据 
都 共享 。 从 这 一 点 来 说 ， 外 部 耦合 的 耦合 度 要 低 于 公共 耦合 的 耦合 度 。 


中 等 级 四 “控制 耦合 
控制 耦合 指 调用 方 模块 以 参数 的 形式 传递 涉及 被 调用 方 模块 内 部 控 
制 的 数据 。 








模块 人 


CALL B(SW) 
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在 控制 耦合 的 模式 下 ， 调 用 方 模块 以 参数 的 形式 将 选择 变量 传递 给 





被 调用 方 模块 ， 从 而 指示 被 调用 方 执行 相应 的 功能 。 因 此 ， 调 用 方 必 须 
知道 被 调用 方 模块 的 逻辑 ， 不 能 将 对 方 当 作 黑 箱 。 这 就 增强 了 耦合 度 。 








控制 看 合 还 有 一 个 缺点 ， 那 就 是 被 调用 方 模块 的 内 聚 度 会 达到 逻辑 








强度 。 不 过 ， 因 为 不 会 共享 数据 ， 所 以 控制 耦合 的 耦合 度 要 低 于 公共 三 





合 和 外 部 耦合 的 耦合 度 。 
等 级 五 ”特征 耦合 





特征 耦合 指 两 个 模块 间 传递 公共 区 域 中 没有 的 数据 结构 。 


数据 模块 B 
结构 体 


S 


模块 A 





数据 结构 通过 参数 传递 。 
在 特征 耦合 的 模式 下 ， 传 递 的 数据 结构 并 不 是 都 能 用 到 的 。 这 一 点 





提高 了 特征 耦合 的 耦合 度 。 


等 级 六 ”数据 耦合 
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数据 耦合 指 模块 间 仅 通过 参数 传递 标量 类 型 的 数据 作为 模块 间 的 接口 。 
为 可 以 将 对 象 模 块 视 为 黑箱 ， 所 以 数据 耦合 的 耦合 度 最 低 。 
在 模块 间 的 耦合 中 ， 通 过 明确 的 参数 传递 数据 的 数据 耦合 最 为 优秀 。 


三 
入 


通过 上 图 可 以 看 出 ,模块 A 将 数据 X 传递 给 模块 B， 用 作 模 块 B 


模块 人 模块 B 


CALL B(X, Y) 





的 输入 数据 ， 然 后 接收 模块 B 输出 的 数据 Y。 至 于 模块 B 是 如 何 将 数据 
X 转换 为 数据 Y 的 ， 模 块 A 不 需要 知道 。 也 就 是 说 ， 模 块 A 可 以 将 模 
块 B 视 为 黑箱 ,模块 B 的 逻辑 修改 不 会 对 模块 A 造成 影响 。 

模块 B 接收 数据 X， 和 输出 数据 Y， 从 内 聚 度 来 看 属于 功能 强度 ， 同 
样 很 优秀 。 

值得 一 提 的 是 ， 特 征 耦 合 传递 的 是 数据 结构 ， 并 且 只 使 用 其 中 一 部 
分 数据 结构 。 如 果 接 收 数据 的 一 方 会 处 理 数 据 结 构 中 的 所 有 数据 ， 那 么 
这 种 耦合 也 可 以 视 为 数据 耦合 。 




















相互 依赖 的 模块 很 脆弱 


耦合 度 高 的 模块 会 相互 依赖 并 且 相 互 影 响 。 很 多 问题 便 由 此 产生 。 

比如 修改 相关 模块 之 后 ， 所 有 与 其 耦合 的 模块 也 要 进行 修改 ， 模 块 
的 运行 也 会 受到 影响 。 

另外 ， 在 使 用 某 个 模块 时 ， 必 须 同 时 使 用 与 其 耦合 的 模块 这 一 点 对 
模块 的 重复 使 用 造成 了 影响 。 

再 者 ， 高 耦合 度 模 块 的 代码 很 难 单独 拿 出 来 理解 。 即 便 结 合 相关 模 
块 的 代码 一 起 阅读 ， 全 局 变量 的 存在 也 会 让 阅读 代码 的 人 难以 掌握 该 模 
块 整体 的 运作 方式 。 
























































以 实现 低 耦 合 的 模块 为 目标 


为 了 提高 模块 的 独立 性 ， 我 们 要 尽量 降低 模块 间接 口 的 耦合 度 。 
具体 做 法 如 下 所 示 。 








@ 尽量 通过 参数 传递 数据 

@ 数据 尽量 不 用 全 局 变量 保存 。 只 用 一 次 的 数据 存放 在 局 部 变量 里 

@ 不 让 模块 的 运行 因 外 界 传 来 的 值 而 发 生 改变 。 如 果 参 数 传 来 的 标 
志 位 内 容 是 “A” 就 执行 添加 ， 是 “DD” 就 执行 删除 ， 那 么 模块 
的 耦合 度 就 会 变 高 
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我 们 还 要 注意 与 当前 模块 相 耦合 的 模块 的 质量 。 虽 说 高 耦合 度 本 号 
就 是 一 个 问题 ， 但 究 其 本 质 ， 其 实 是 模块 与 不 稳定 要 素 的 耦合 在 作 崇 。 
模块 依赖 于 稳定 的 库 就 不 会 带 来 什么 问题 。 

与 其 育 目 追求 数据 耦合 ， 不 如 根据 耦合 对 象 来 判断 模块 间 耦 合 到 哪 
种 级 别 比 较 合 适 。 


ANNA 


有 观点 认为 ， 耦 合 度 的 分 类 中 还 包括 混合 耦合 。 
混合 耦合 表示 数据 在 不 同 状态 下 可 以 存在 多 重 意义 。 比 如 计算 税率 
的 函数 在 计算 不 合法 时 会 返回 负数 值 来 表示 出 错 。 

















@ 正常 时 : 税率 
@ 异常 时 : 负数 值 


在 这 种 情况 下 ， 返 回 值 会 根据 具体 情况 而 发 生变 化 。 这 就 要 求 函 数 使 
用 方 在 使 用 函数 时 必须 注意 到 这 一 点 。 因 此 ， 混 合 看 合 的 而 合 度 略 高 。 


耦合 的 个 数 与 方向 


对 于 耦合 度 ， 我 们 要 把 着 眼 点 放 在 耦合 的 “强度 ”和 “松紧 程度 ”上 。 

而 对 于 耦合 ， 我 们 要 注意 的 地 方 就 不 止 这 两 个 了 。 除 了 要 看 “ 强 
”和 “松紧 程度 ”"， 还 要 注意 “个 数 ” 与 “方向 ”。 

与 其 他 模块 有 双向 关系 的 模块 ， 拥 有 和 高 耦合 度 模块 一 样 的 弊端 。 








尖 


3: 冯 有 二 量 展 等 性 与 安全 性 


有 观点 认为 ， 模 块 与 函数 具有 竹 等 性 和 安全 性 。 





e 窜 等 性 
惫 等 性 是 数学 术语 ， 表 示 对 于 某 操 作 ， 无 论 执 行 多 少 次 都 会 得 到 相 
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同 的 结果 。 同 一 个 函数 无 论 被 调用 多 少 次 ， 得 到 的 结果 都 是 一 样 的 。 
比如 0 的 笠 法 计算 就 是 需 等 的 。“3x0”“(3x0)x0”“((3x0)x0)x0” 
全 部 等 于 0。 

另外 ， 绝 对 值 计 算 也 是 霸 等 的 。 “abs(-3)””“abs(abs(-3))” 
“abs(abs(abs( 一 3)))” 的 结果 都 是 3。 


e 安全 性 
安全 性 指 不 让 操作 对 象 的 状态 发 生变 化 。 
而 副作用 表示 使 状态 发 生变 化 ， 所 以 安全 性 还 可 以 说 成 “对 操作 
对 象 的 状态 没有 副作用 ”。 











具有 安全 性 和 需 等 性 的 服务 器 能 让 客户 端 放 心地 以 操作 黑箱 的 方式 
使 用 服务 。 对 于 HTTP 请 求 等 在 易于 发 生 错 误 的 网 络 环境 中 使 用 的 协 
议 ， 这 两 个 特性 尤其 有 用 。 

比如 HTTP (HyperText Transfer Protocol， 超 文本 传输 协议 ) 的 GET 
请 求 就 要 求 是 震 等 旦 安全 的 。 这 样 一 来 ， 发 送 GET 请 求 后 如 果 没 有 返 
回响 应 ， 用 户 只 要 重新 发 送 一 次 请 求 即 可 。 因 为 可 以 保证 获取 相同 的 结 
果 ， 所 以 即便 前 一 次 的 请 求 也 被 处 理 了 ， 对 服务 器 来 说 也 不 会 有 什么 实 
质 性 的 影响 。 
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正六 仁 


英 语 Orthogonality 





2 代码 独立 


正 交 在 几何 学 中 指 两 条 线段 如 直角 坐标 系 一 般 相 交 且 成 直角 。 计 某 
点 沿 x 轴 平移 时 ，x 值 会 发 生变 化 ,但 y 值 不 变 。 也 就 是 说 ,x 值 的 改变 
不 会 对 yy 值 造成 影响 。 

代码 也 应 满足 正 交 性 。 也 就 是 说 ， 代 码 之 间 应 具有 独立 性 和 分 离 性 。 

假设 有 两 组 代码 。 如 果 修 改 其 中 一 方 不 会 对 男 外 一 方 造成 影响 ， 那 
么 这 两 组 代码 就 是 正 交 的 。 正 交 的 代码 在 修改 时 不 容易 出 现 问题 。 

比如 访问 数据 库 的 代码 和 用 户 接口 代码 就 可 以 设计 成 正 交 的 。 这 样 
一 来 ， 我 们 就 能 在 不 对 访问 数据 库 的 代码 造成 影响 的 情况 下 修改 用 户 接 
口 ， 还 能 在 不 修改 用 户 接口 的 情况 下 更 换 数据 库 。 









































正 交 的 代码 更 牢固 


让 代码 具有 正 交 性 可 以 获得 以 下 两 点 好 处 。 





e@ 提高 生产 效率 

代码 具有 正 交 性 后 ， 修 改 会 控制 在 局 部 范围 。 开 发 周期 和 测试 周 
期 会 因此 而 缩短 。 此 外 ， 代 码 的 耦合 度 也 会 降低 ， 这 有 助 于 代码 
的 重复 使 用 。 





e 降低 风险 
代码 具有 正 交 性 后 ， 发 生 问题 的 部 分 可 以 被 立刻 隔离 起 来 ， 代 码 也 
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由 此 变 得 更 加 牢固 。 另 外 ， 代 码 的 依赖 性 较 弱 ， 便 于 测试 和 检验 。 


二 代码 层次 化 





我 们 要 让 模块 间 的 耦合 度 最 小 化 。 也 就 是 说 ， 不 对 其 他 模块 公开 不 
必要 的 信息 ， 与 此 同时 ， 保 证 代码 不 依赖 于 其 他 模块 的 实现 。 

层次 化 是 将 代码 之 间 的 耦合 度 最 小 化 的 有 效 手段 。 软 件 应 该 由 包含 
一 个 个 独立 功能 的 模块 组 合 而 成 。 这 些 模 块 要 分 层次 整理 、 抽 象 化 。 各 
层次 只 使 用 下 一 层次 提供 的 抽象 化 功能 。 这 样 一 来 ， 下 层 代 码 的 修改 就 
不 会 对 上 层 代码 造成 影响 ， 灵 活性 大 大 提高 。 

此 外 ,代码 的 层次 化 使 模块 之 间 的 关系 得 到 整理 ， 降 低 了 模块 间 依 
赖 程度 呈 指 数 上 升 的 可 能 性 。 
反 过 来 ， 使 用 全 局 数据 会 最 大 化 代码 间 的 耦合 度 。 代 码 一 旦 使 用 了 
全 局 数据 ， 就 会 与 其 他 共享 该 数据 的 成 分 紧密 关联 起 来 。 为 了 满足 正 交 
性 ， 一 定 不 要 使 用 全 局 数据 。 









































层次 化 的 好 处 与 坏处 


层次 化 是 用 于 分 割 复杂 软件 系统 的 方法 。 这 一 方法 既 基 础 又 重要 ， 
许多 领域 的 架构 设计 使 用 了 该 方法 。 

在 运用 层次 化 的 示例 中 ， 最 具 代 表 性 的 就 是 网 络 协议 。 我 们 以 网 络 
协议 为 例 来 看 一 下 层次 化 的 好 处 。 






































@ 可 以 将 一 个 层次 视 为 整体 ， 不 必 熟 悉 其 他 层次 。 比 如 即便 不 熟悉 
以 大 网 的 运作 方式 ， 也 能 理解 在 TCP (Transmission Control 
Protocol， 传 输 控 制 协议 ) 上 搭建 FTP ( File Transfer Protocol， 文 
件 传输 协议 ) 服务 的 方法 

@ 可 以 在 不 影响 其 他 层次 的 前 提 下 置换 整 层 代码 。 比 如 以 太 网 、 
PPP (Point to Point Protocol， 点 对 点 协议 ) 及 网 络 运营 商 的 改变 并 
不 会 影响 FTP 服 务 的 运行 
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@ 可 以 最 小 化 各 层次 间 的 依赖 程度 。 比 如 网 络 运营 商 变 更 了 与 IP 
(Internet Protocol， 网 际 协议 ) 有 关 的 物理 传输 系统 ， 在 这 种 情 
况 下 FTP 服 务 并 不 需要 进行 修改 

@ 层次 结构 适合 标准 化 。TCP/IP 就 是 定义 了 层次 运作 方法 的 标准 
通信 协议 

@ 实现 层次 化 后 ， 许 多 高 水 平 服务 就 可 以 使 用 层次 结构 了 。TCP/ 
IP 被 ftp、telnet、ssh 和 HTTP 使 用 。 没 有 TCP/IP， 高 水 平 协议 就 
必须 创建 独立 的 低 水 平 协议 


不 过 ， 层 次 化 也 有 弱点 。 

首先 ， 层 次 之 间 的 修改 可 能 会 发 生 连 锁 效 应 。 比 如 通过 软件 用 户 接 
口 添加 字段 的 情况 。 字 段 要 保存 在 数据 库 中 ， 因 此 从 用 户 接口 到 数据 库 
之 间 的 所 有 层 都 要 添加 该 字段 。 

另外 ， 添 加 层次 后 ， 性 能 可 能 会 变 差 。 数 据 每 通过 一 层 就 要 转换 一 
次 格式 ， 这 种 转换 会 给 性 能 带 来 负担 。 




















二 :7 冯 且 二 昌吉 关系 的 正 交 性 











正 交 性 这 个 词 在 不 同 的 语 境 下 有 不 同 的 含义 。 
在 关系 数据 库 的 基础 理论 “关系 模型 ”中 ， 有 一 个 与 规范 化 同等 重 











要 的 概念 。 这 个 概念 就 是 “关系 的 正 交 性 ”。 这 里 所 说 的 正 交 性 与 代码 
的 正 交 性 意义 不 同 。 





正规 化 指 从 一 个 关系 (= 表 ) 的 内 部 消除 重复 。 

而 关系 的 正 交 性 是 一 个 与 多 个 关系 间 的 重复 有 关 的 概念 。 从 编程 的 
角度 来 讲 ， 这 个 概念 更 接近 于 DRY 原则 。 简 单 来 说 就 是 不 含 相同 的 值 。 

下 面 我 们 通过 例子 来 看 一 下 含有 相同 的 值 是 一 个 什么 样 的 状态 

















e 副本 
复制 表 后 ， 值 会 出 现 重复 。 
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e 同类 型 的 关系 
按 年 度 分 成 多 个 表 这 种 设计 就 无 法 保证 不 出 现 相 同 的 值 。 


通过 正规 化 消除 了 单个 关系 中 的 重复 后 ， 如 果 从 数据 库 的 整体 来 看 
仍 存在 重复 ， 那 么 关系 之 间 依 旧 是 相互 矛盾 的 。 关 系 是 真 命题 的 集合 ， 
某 个 关系 与 其 他 关系 不 能 同时 含有 相互 矛盾 的 事实 。 

因此 我 们 需要 消除 整个 数据 库 的 重复 ， 保 证 关系 的 正 交 性 。 























冯 ; 冯 司 二 关系 的 定义 





经 常 有 人 把 关系 错误 理解 成 “ 表 与 表 之 间 的 关系 "， 认 为 关系 模型 
用 于 (通过 ER 图 等 ) 设计 表 与 表 之 间 的 关系 。 这 其 实 是 一 种 误解 。 

实际 上 ， 关 系 模型 中 的 关系 是 SQL 中 的 “ 表 ”。 

关系 模型 中 的 关系 由 “目录 ”和 “主体 ”成 对 构成 。 目 录 是 多 个 属 
性 的 集合 ， 这 些 属 性 由 名 称 与 数据 类 型 成 对 构成 。 主 体 则 是 聚集 了 属性 
值 的 元 组 集合 。 

放 到 SQL 中 来 说 ， 关 系 就 是 “ 表 ”， 属 性 就 是 “ 列 ”， 元 组 就 是 “ 行 ”。 
目录 ( 列 ) 
到 书 编号 : 整数 





























| 

































图 书 名 称 : 字符 串 
































































S 书 编号 : 2 
到 书 名 称 ， Ruby 入 门 
乍 者 名 : 佐 蕨 真理 




























书 名 称 Per 入门 
作者 名 : 加 蕨 诚 
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可 逆 性 


英 语 Reversibility 





选择 可 以 “UNDO” 的 方案 


可 逆 指 发 生 某 种 变化 后 ， 可 通过 添加 条 件 回 到 原本 状态 的 性 质 。 

程序 中 的 判断 应 时 常 保持 可 逆 性 。 禁 止 使 用 无 法 还 原 的 方案 。 

我 们 不 可 能 永远 都 用 同一 个 方案 来 解决 问题 。 现 实 世 界 瞬 息 万 变 ， 
受 其 影响 的 软件 必须 由 灵活 且 适 应 性 强 的 可 道 代码 构成 。 

即便 方案 已 经 确定 ， 发 生 问题 时 也 要 保证 代码 能 回 到 之 前 的 状态 ， 
这 样 能 将 风险 控制 在 局 部 范围 ， 使 风险 最 小 化 。 











AAA 汪 不 存在 所 谓 的 最 终 方 案 


程序 员 总 倾向 于 寻求 独一无二 的 最 终 方案 。 

然而 最 终 方 案 并 不 存在 。 万 事 万 物 都 在 发 生变 化 。 如 果 过 度 依赖 某 
一 个 事实 ,那么 当 该 事实 发 生变 化 时 ， 代 码 就 会 出 现 问题 。 

比如 我 们 在 使 用 依赖 于 框架 的 设计 时 ， 会 遇 到 开发 到 一 半 被 迫 放弃 
使 用 该 框架 的 情况 。 理 由 可 能 是 安全 问题 、 许 可 证 价格 问题 等 ， 总 之 有 
很 多 外 部 因素 是 程序 员 无 法 控制 的 。 

一 旦 发 生 这 种 情况 ， 我 们 就 要 推翻 前 面 所 有 的 设计 。 这 将 带 来 巨大 
的 损失 。 
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过量 不 依赖 于 特定 技术 


为 了 能 经 受 住 变化 的 考验 ,我 们 的 设计 需要 能 回 到 之 前 的 状态 。 

为 此 ， 代 码 一 定 要 有 灵活 性 ， 不 依赖 于 特定 技术 ， 能 灵活 应 对 变化 。 

人 类 不 可 能 每 次 都 做 出 最 正确 的 决策 ， 所 以 我 们 只 能 让 代码 随时 应 
对 修改 。 举 个 例子 ， 我 们 会 遇 到 在 项 目 中 途 更 换 数据 库 管 理 系 统 的 情 
况 。 如 果 事先 考虑 了 可 逆 性 ， 访 问 数据 库 的 部 分 也 实现 了 抽象 化 ,那么 
数据 库 管 理 系统 的 更 换 操作 就 能 在 几 个 步骤 之 内 完成 。 

不 过 ， 我 们 不 可 能 准确 预测 未 来 。 写 代码 时 做 到 未 雨 绸 缪 是 一 件 很 
难 的 事 。 一 旦 没有 把 握 好 度 ， 设 计 就 会 变 得 复杂 。 
所 以 我 们 要 考虑 风险 发 生 的 概率 以 及 风险 发 生 时 所 造成 的 影响 ,在 
J 逆 设计 与 简单 设计 之 间 寻 找平 衡 点 。 


架构 的 可 逆 性 


在 编写 代码 时 ， 最 重要 的 是 保持 设计 的 灵活 性 。 

此 外 ,在 编写 详细 代码 之 前 ， 也 就 是 在 架构 的 设计 阶段 ， 我 们 就 应 
该 将 可 逆 性 纳入 思考 的 范围 了 。 

软件 与 外 部 的 交界 面 ， 如 配置 平台 或 第 三 方 组 件 等 就 很 适合 实现 可 
道 性 。 为 了 让 这 些 部 分 具有 灵活 性 ,设置 间接 化 的 层次 等 方法 必须 在 架 
构 设 计 阶 段 就 确定 下 来 。 
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代码 中 的 “ 坏 味 ” 


英 语 Bad smell in code 





2 不 要 放 过 代码 的 凶 兆 





代码 中 的 坏 味 指 代码 中 难以 理解 、 难 以 修改 、 难 以 扩展 的 部 分 。 这 些 可 
能 潜藏 问题 的 部 分 是 不 祥 的 预兆 ， 是 一 种 特殊 的 信号 ， 我 们 把 它 称 为 “ 坏 味 ”。 
程序 员 必 须 能 嗅 出 这 股 “ 坏 味 "， 并 对 其 进行 优化 。 











嗅觉 是 重 构 的 必要 条 件 


重 构 对 代码 的 优化 来 说 必 不 可 少 。 

重 构 指 在 不 改变 代码 外 部 行为 的 前 提 下 ， 对 代码 内 部 的 结构 进行 优 
化 。 重 构 也 称 为 “代码 体质 优化 ”。 

整洁 的 代码 读 起 来 轻松 ， 改 起 来 轻松 ,调试 起 来 也 轻松 。 而 对 于 不 
整洁 的 代码 ， 我 们 不 管 做 什么 都 很 麻烦 。 当 手边 有 不 整洁 的 代码 时 ， 我 
们 需要 在 不 产生 新 故障 的 前 提 下 将 其 改写 为 整洁 的 代码 。 这 种 行为 或 者 
说 技术 就 是 重 构 。 

代码 是 有 生命 的 。 对 我 们 来 说 ， 软 件 发 布 并 不 意味 着 结束 ， 之 后 我 
们 还 要 解决 故障 、 添 加 功能 ， 有 时 还 要 将 构成 软件 的 模块 拿 去 给 其 他 软 
件 重复 使 用 。 如 果 修 改 代 码 时 只 跟着 代码 的 走向 进行 修改 ， 添 加 功能 时 
只 顾 眼 前 ,代码 就 会 越 来 越 不 整洁 。 这 样 一 来 ， 阅 读 、 修 正和 调试 都 会 
愈加 困难 。 这 和 不 进行 健康 管理 的 人 身体 会 变 得 越 来 越 差 是 一 样 的 道理 。 

对 人 而 言 ， 如 果 多 花 些 时 间 在 看 似 无 用 的 健康 管理 上 ， 体 质 就 能 有 
所 改善 。 同 样 ， 代 码 也 可 以 通过 看 似 无 用 的 重 构 来 优化 体质 ， 使 代码 变 
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得 易于 修改 ， 功 能 的 添加 变 得 更 加 安全 。 

不 过 ， 在 通过 重 构 优化 代码 时 ， 我 们 必须 能 判断 出 哪些 代码 需要 优 
化 。 我 们 可 以 从 重 构 的 目录 上 获取 一 部 分 信息 。 不 过 ， 目 录 上 写 的 情况 
与 我 们 面 对 的 情况 大 多 不 一 致 。 

所 以 ， 对 于 设计 上 经 常 出 现 的 问题 ， 我 们 要 了 解 相关 知识 ， 保 证 能 
及 时 发 现 问 题 。 也 就 是 说 ,我 们 要 能 嗅 出 这 些 设计 上 的 “ 坏 味 ”。 




















了 解 代码 出 现 “ 坏 味 ” 时 的 征兆 


我 们 要 了 解 代码 出 现 “ 坏 味 ” 时 的 征兆 。 
下 面 几 种 情况 会 导致 代码 中 出 现 “ 坏 味 "。 对 于 每 种 情况 ， 我 们 不 但 
要 知道 什么 状态 是 有 “ 坏 味 ” 的 ,还 要 了 解 为 什么 这 种 状态 会 有 “ 坏 味 ”。 








e 代码 重复 

代码 重复 指 的 是 相同 的 代码 散布 在 软件 各 处 的 状态 。 复 制 、 粘 贴 
代码 的 行为 会 导致 重复 的 代码 大 量 存在 。 

重复 的 代码 会 加 大 修改 的 难度 ， 因 为 在 发 生 故 障 的 情况 下 ， 我 们 
要 同时 修改 多 个 位 置 的 代码 。 

我 们 应 将 重复 的 代码 整合 到 一 个 函数 里 。 


e 函数 太 长 

函数 太 长 指 的 是 向 下 翻 几 页 都 看 不 到 函数 尽头 的 状态 。 

函数 太 长 会 影响 理解 。 在 这 种 情况 下 ,我 们 无 法 将 函数 的 功能 总 
结 成 “这 个 函数 用 于 实现 A” 这样 简 短 的 一 句 话 。 兄 数 的 说 明 将 
变 成 “这 个 函数 是 实现 义 、Y、Z 和 ……”。 

我 们 应 将 过 长 的 函数 分 割 成 若干 个 小 函数 。 


模块 太 大 

模块 太 大 指 的 是 模块 因 规模 太 大 而 难以 管理 的 状态 。 

模块 过 大 ， 表 明 该 模块 承担 的 责任 过 重 。 过 大 的 模块 让 人 难以 理 
解 。 另 外 ， 当 模块 的 责任 过 重 时 ， 模 块 被 修改 的 概率 也 会 增加 。 
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随 着 时 间 的 推移 ， 模 块 将 越 来 越 大 ， 越 来 越 难以 管理 。 
我 们 应 将 过 大 的 模块 分 割 成 多 个 小 模块 。 


模块 太 多 

模块 太 多 指 的 是 模块 因数 量 过 多 而 难以 管理 的 状态 。 

大 模块 要 分 解 ， 但 不 能 分 解 得 太 小 ， 否 则 模块 数量 就 会 增多 ,， 反 
而 难以 管理 。 

减轻 责任 是 有 限度 的 。 大 模块 让 人 难以 理解 ， 模 块 过 多 也 一 样 ， 因 为 
模块 增多 意味 着 关联 增多 ， 这 样 一 来 ， 我 们 就 难以 掌握 代码 的 流程 了 。 
当 模 块 过 多 时 ， 我 们 可 以 删除 用 处 不 大 的 中 介 模 块 ， 或 者 通过 废 
除 、 合 并 等 方式 减少 模块 的 数量 。 


名 称 不 一 臻 

名 称 不 一 致 指 的 是 名 称 与 实际 代码 不 一 致 的 状态 。 

名 称 很 重要 。 代 码 中 会 出 现 大 量 名 称 。 这 些 名 称 的 作用 是 向 读 代 码 的 
人 传递 恰当 的 信息 。 在 编写 代码 时 ， 程 序 员 必须 注意 命名 的 正确 性 。 
名 称 并 不 是 一 成 不 变 的 。 代 码 有 生命 ， 随 着 修改 的 不 断 进行 ， 一 
开始 正确 的 名 称 到 后 面 也 会 变 得 不 合适 。 

当 我 们 发 现代 码 表达 的 概念 与 名 称 不 相符 时 ， 一 定 要 立刻 更 正名 称 。 
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技术 负债 


英 语 Technical debt 





问题 代码 是 “ 欠 款 ” 


编程 有 两 条 路 ,一 条 是 花费 大 把 时 间 写 出 整洁 的 代码 ， 男 一 条 是 快 
速写 出 不 整洁 的 代码 。 

如 果 时 间 充 裕 ， 应 该 坚持 选择 “花费 大 把 时 间 写 出 整洁 的 代码 ”这 
条 路 。 但 如 果 时 间 不 够 ， 修 改 又 比较 紧急 ， 有 时 也 可 以 选择 “快速 写 出 
不 整洁 的 代码 ”这 条 路 。 

不 过 ， 当 我 们 选择 “快速 写 出 不 整洁 的 代码 ”这 条 路 时 ， 软 件 就 等 
于 背 上 了 “债务 "”。 这 就 是 技术 负债 。 

技术 负债 中 的 “债务 ”是 代码 中 难以 修改 、 难 以 理解 的 代码 。 它 并 
不 是 指 故障 本 身 ， 而 是 指 会 给 故障 创造 条 件 以 及 阻碍 故障 排查 的 问题 代 
码 。 我 们 把 这 个 有 问题 的 代码 比 作 “ 债 务 ”， 也 就 是 “ 欠 款 ”。 

在 商业 中 ， 和 暂时 缘 负债 务 的 情况 并 不 少见 。 只 要 能 及 时 还 清 欠 款 ， 
就 不 会 有 任何 问题 。 然 而 债务 是 会 产生 利息 的 。 拖 久 了 ， 利 息 就 会 增 
多 ， 还 款 也 会 变 得 困难 ， 甚 至 会 出 现 无 法 还 清 的 情况 。 

这 种 情况 在 代码 中 也 是 存在 的 。 

即便 暂时 写 下 了 不 整洁 的 代码 ， 只 要 我 们 能 及 时 还 清 欠 款 ， 就 不 会 
有 问题 。 这 里 的 还 清 欠 球 是 指 让 代码 回 深 到 修改 之 前 ， 然 后 用 充裕 的 时 
间 编 写 正确 的 代码 ， 也 就 是 把 不 整洁 的 代码 修改 成 整洁 的 代码 。 

然而 ， 如 果 不 能 及 时 还 清 众 款 ， 就 会 产生 利息 。 不 整洁 的 代码 在 软 
件 里 逗留 的 时 间 过 久 会 使 问题 严重 化 ， 这 就 是 “利息 "”。 阅 读 负债 的 代 
码 很 费时 间 ， 而 且 一 次 次 的 修改 会 让 代码 变 得 越 来 越 不 整洁 ， 整 个 软件 
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的 运行 也 会 变 得 不 稳定 。 于 是 ， 利 息 越 滚 越 多 。 

等 到 负债 过 多 的 时 候 ， 我 们 就 会 陷入 无 力 偿还 的 境地 。 那 时 ， 代 码 
将 变 得 不 稳定 且 无 法 修改 。 既 不 能 添加 功能 ， 又 不 能 维护 。 

这 样 一 来 ， 软 件 便 失 去 了 为 用 户 提供 价值 的 能 力 。 





1 区 AAA 汪 技 术 负债 会 恶性 循环 








技术 负债 会 恶性 循环 。 

代码 一 旦 变 得 难以 理解 ， 添 加 功能 所 花费 的 时 间 就 会 增多 。 男 外 ， 
寻找 故障 、 修 复 故障 所 需要 的 时 间 也 会 增加 。 

所 需 时 间 增 加 ， 就 意味 着 尚未 还 清 的 债务 会 进一步 膨胀 。 这 就 浪费 
了 一 部 分 时 间 ， 使 团队 无 法 完成 原本 应 该 做 的 事情 。 

不 过 ， 在 软件 开发 中 ,“ 借 用 时 间 ” 是 一 种 常见 的 策略 。 该 策略 可 
以 让 我 们 完成 需要 完成 事情 ， 达 成 具有 一 定 风险 的 目标 。 在 有 限 的 时 间 
内 我 们 可 能 无 法 编写 出 完美 的 代码 ， 但 我 们 可 以 放 低 要求 ， 编 写 出 满足 
基本 需求 的 代码 。 这 样 ， 即 使 软件 暂时 处 于 不 完美 的 状态 ， 我 们 也 可 以 
通过 对 软件 进行 管理 来 弥补 “ 放 低 要 求 ” 带 来 的 损失 。 

然而 ， 如 果 欠 球 一 直 拖 着 ,我 们 就 会 陷入 无 力 偿还 的 窘境。 在 没有 
还 清 欠 款 的 情况 下 继续 借债 ， 只 会 让 软件 陷入 更 大 的 危险 。 

所 以 我 们 需要 在 编程 中 引入 技术 负债 这 个 概念 ， 对 欠 款 加 以 控制 。 
我 们 不 能 对 欠 款 采取 避讳 的 态度 ， 而 要 承认 它 的 存在 并 与 它 和 睦 相 处 。 


管理 问题 代码 


我 们 要 在 编程 中 引入 技术 负债 这 个 概念 ， 管 理 问题 代码 。 

一 想到 技术 负债 的 利息 ， 很 多 人 就 会 觉得 代价 过 高 ， 自 己 负担 不 
起 。 然 而 当 我 们 需要 在 尽快 修复 故障 和 蒙受 巨大 损失 之 间 进 行 选择 时 (在 
出 现 严重 故障 的 情况 下 )， 快 速 修 复 不 整洁 的 代码 一 定 是 正确 的 选择 。 

不 过 ,解决 完 故 障 并 不 代表 万 事 大 吉 。 技 术 负 债 越 快 偿还 越 好 。 用 
不 整洁 的 代码 赶 在 时 限 之 内 成 功 发 布 后 ， 应 当 立 刻 让 代码 回 深 到 原先 的 
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状态 ， 将 代码 修改 成 原本 就 应 该 实现 的 整洁 的 代码 。 趁 自己 还 记得 哪些 
代码 有 问题 ， 应 尽快 还 清 所 有 欠 款 ,然后 借 下 一 次 发 布 的 机 会 把 修改 的 
部 分 添加 到 软件 中 。 这 种 做 法 才 是 最 保险 的 。 这 就 好 比 信用 卡 ， 我 们 买 
东西 时 从 下 了 债务 ， 只 要 在 还 款 日 之 前 付 清 ， 就 不 必 文 付 利息 。 

只 要 能 保证 如 此 运用 债务 ， 我 们 就 能 在 快速 应 对 商业 需求 的 同时 ， 
避免 项 目 陷 入 欠 球 的 无 底 洞 。 

如 果实 在 没有 时 间 还 债 ， 至 少 要 把 本 应 编写 的 代码 设计 记录 在 文 
档 中 。 


























ES 技 术 负 债 用 于 说 明代 码 整洁 的 意义 


“技术 负债 ”这 个 比喻 能 帮助 那些 对 代码 不 是 很 熟悉 的 人 理解 代码 
整洁 的 意义 。“ 代 码 能 运行 就 可 以 ， 没 有 那么 整洁 也 无 所 谓 ”“ 没 必要 去 
修改 能 运行 的 代码 ”“ 运 行 即 正确 ”…… 持 有 这 类 想法 的 人 并 不 少 。 只 
有 编写 代码 和 维护 代码 的 人 才能 切身 体会 到 保持 代码 整洁 的 必要 性 。 对 
于 一 些 不 写 代码 的 上 司 ， 我们 可 以 把 技术 负债 的 概念 讲 给 他 听 ， 这 么 做 
或 许 能 争取 到 一 些 时 间 。 














问题 代码 出 现 的 原因 
以 下 几 个 要 素 是 诱发 问题 代码 出 现 及 扩散 的 原因 。 


@ 经 验 不 足 的 程序 员 
@ 交付 日 期 的 压力 
@ 可 读 性 低 的 代码 
@ 特殊 化 的 代码 

@ 无 用 的 复杂 代码 
@ 低 质 量 的 设计 


男 外 ， 以 下 这 些 团 队 文 化 也 是 诱发 问题 代码 出 现 及 扩散 的 原因 。 
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@ 不 提倡 写 整 洁 的 代码 

@ 接纳 不 明确 的 代码 

@ 不 给 重 构 留 时 间 

@ 发 布 之 前 才 做 回归 测试 

@ 没有 勇气 替换 包含 大 量 依赖 关系 的 旧 系 统 
@ 随意 创建 分 支 


我 们 要 对 这 些 诱因 加 以 注意 ， 防 止 不 整洁 的 代码 蔓延 。 


对 于 诱因 不 属于 以 上 内 容 的 问题 代码 ， 应 将 其 当 作 技 术 负债 进行 
管理 。 


:有 二 技术 病 





在 技术 负债 中 ， 我 们 将 问题 代码 比 作 “ 欠 款 ”"， 其 实 这 类 问题 代码 
也 可 以 用 “ 病 ” 来 比喻 。 

如 果 在 “生病 ”的 软件 中 修改 某 部 分 内 容 ， 那 么 其 他 没有 关联 的 部 
分 也 会 遭 到 损坏 。 放 任 不 管 的 话 ,“ 病 ”不 仅 不 会 竣 愈 ， 反 而 会 逐渐 恶 
化 ， 所 以 必须 实施 “手术 "。 就 像 外 科 医 生 敢 于 实施 手术 治疗 患者 病痛 
一 样 ， 我 们 要 敢于 修改 代码 ， 积 极 改良 系统 。 

对 系统 而 言 ,“ 手 术 ” 就 是 重 构 。 重 构 需 要 花费 时 间 与 劳力 ， 但 在 
项 目 进行 的 过 程 中 ， 这 部 分 投资 足以 收回 本 钱 。 不 仅 如 此 ， 还 会 获得 数 
倍 的 收益 。 
再 者 ， 治 系统 的 “ 病 ” 也 可 以 让 项 目 成 员 获 取经 验 。 这 些 经 验 能 加 
深 团队 成 员 对 软件 本 质 的 了 解 ， 让 他 们 成 为 这 款 软件 的 专家 。 

因此 ， 我 们 应 积极 地 进行 重 构 ， 不 能 害怕 修改 。 躺 在 原 地 一 动 不 
动 ， 身 体 只 会 越 来 越 差 。 

需要 注意 的 是 ， 改 善 操作 要 慢 且 精 。 男 外 ， 每 执行 一 次 改善 操作 就 
要 测试 一 次 。 一 次 性 进行 大 幅度 的 修改 是 很 危险 的 。 一 旦 修改 出 现 问 
题 ， 之 前 所 做 的 改善 都 会 付 之 东 流 。 
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司 : 忆 有 二 区 临时 解决 方案 


与 技术 负债 类 似 的 概念 还 有 “临时 解决 方案 ”。 

在 时 间 紧 迫 的 情况 下 为 渡 过 难关 而 采取 的 措施 就 是 临时 解决 方案 。 

临时 解决 方案 应 单独 处 理 ， 不 能 放 在 正在 开发 的 软件 中 。 临 时 解 
决 方案 在 最 开始 的 时 候 是 当 作 草 案 来 创建 的 。 由 于 时 间 紧 近 ， 在 创建 时 
无 法 完全 遵守 本 应 遵守 的 规则 ， 所 以 临时 解决 方案 以 将 来 会 进行 修改 为 
前 提 。 
不 过 ， 临 时 解决 方案 中 潜藏 着 一 种 “惯性 法 则 ”。 这 个 法 则 就 是 临 
时 解决 方案 一 旦 出 台 ， 就 会 变 为 既成 事实 。 临 时 解决 方案 已 经 存在 ， 而 
且 发 挥 了 作用 ， 团 队 成 员 接受 后 ， 就 不 会 觉得 需要 去 尽快 修改 它 了 。 实 
际 上 ， 临 时 解决 方案 也 需要 尽早 整合 到 系统 中 ， 但 重要 的 工作 实在 大 
多 ， 于 是 这 项 工作 就 被 搁置 了 下 来 。 

结果 ， 临 时 解决 方案 挂 着 “临时 ”的 名 字 ， 一 直 放 在 那里 得 不 到 修 
改 。 本 来 是 临时 抱佛脚 的 产物 ， 但 它 却 长 期 留存 了 下 来 。 

不 过 ， 在 整个 项 目 中 ， 一 个 临时 解决 方案 都 不 创建 是 不 现实 的 。 这 
会 让 我 们 来 不 及 解决 某 些 问题 。 

所 以 ， 对 于 临时 解决 方案 ， 我 们 应 采取 与 技术 负债 相同 的 方式 进行 
管理 。 
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习惯 实际 上 已 成 为 天 性 的 一 部 分 。 


一 一 亚 里 士 多 德 


程序 员 的 三 大 美德 


莫 语 Three great virtues of a programmer 





入 程序 员 要 懒惰 、 急 躁 和 傲慢 


程序 员 的 三 大 美德 总 结 出 了 一 个 优秀 程序 员 应 该 具备 的 特质 。 
这 三 个 美德 分 别 是 懒惰 、 急 躁 和 傲慢 。 具 体 定 义 如 下 所 示 。 























e 懒惰 
懒惰 指 不 遗 余力 地 减少 整体 劳力 的 消耗 。 为 了 让 后 来 人 更 加 轻 
松 ， 应 编写 高 效率 的 代码 。 


e 急躁 

急躁 指 在 计算 机 偷懒 的 时 候 会 感到 愤怒 。 当 计算 机 的 工作 效率 令 人 
不 满 ， 或 者 计算 机 没有 按照 预想 的 方式 工作 时 ， 应 立即 修改 代码 。 
另外 ， 编 写 代码 时 不 仅 要 注意 眼前 的 问题 ， 还 要 预想 今后 可 能 
现 的 问题 。 


e 傲慢 


傲慢 指 拥 有 极 强 的 自尊 心 。 保 持 这 种 自尊 心 ， 促 使 自己 写 出 让 别 
人 挑 不 出 毛病 的 代码 。 


2 和 | 懒惰、 急躁 和 傲慢 可 以 让 工作 结构 化 





这 三 大 美德 乍 一 看 都 是 一 些 不 好 的 德行 ， 其 实 并 非 如 此 。 勤 勉 、 宽 
容 和 谦虚 更 符合 这 三 大 美德 所 表达 的 意思 
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然而 对 程序 员 来 说 ， 人 懒惰 、 急 蹊 和 做 慢 这 种 说 法 更 加 合理 。 这 么 说 
是 有 原因 的 。 


e 懒惰 
懒 情 并 不 是 指 心态 懒散 不 愿 工作 。 
在 我 们 的 日 常生 活 中 ， 有 很 多 需要 重复 许多 遍 的 工作 。 对 于 这 种 
工作 ,我们 应 当 有 采取“ 懒惰” 的 态度 ， 尽 量 不 自己 动手 ， 而 是 交 
由 软件 自动 化 完成 。 也 就 是 说 ， 让 计算 机 来 完成 这 些 工作 。 
这 样 一 来 ， 那 些 需 要 多 人 重复 多 遍 的 工作 就 可 以 用 较 少 的 时 间 来 
完成 ， 而 且 工 作 的 正确 性 也 能 得 到 保证 。 





急躁 

急躁 并 不 是 指 冲 着 计算 机 发 火 。 

计算 机 有 时 会 不 按 我 们 预想 的 方式 工作 。 这 时 我 们 应 当 急 躁 起 
来 ， 动 手 修改 代码 ， 让 计算 机 按照 我 们 预想 的 方式 工作 。 

这 样 一 来 ， 用 在 忍耐 计算 机 上 的 时 间 就 转变 成 了 顺利 进行 操作 的 
时 间 。 工 作 质量 将 得 到 提升 ， 完 成 工作 所 需要 的 时 间 也 会 缩短 。 


e 傲慢 
保持 较 强 的 自尊 心 并 不 是 指 对 周围 的 人 飞扬 跨 雇 。 
自己 写 出 来 的 代码 ， 应 该 不 羞 于 见 人 。 要 对 代码 有 责任 感 。 对 工 
作成 果 应 “傲慢 ”， 要 以 专家 的 态度 对 待 工作 。 
这 样 一 来 ， 我 们 就 可 以 养 成 编写 整洁 代码 的 习惯 了 。 
软件 离 不 开 维护 。 如 果 此 时 代码 的 可 读 性 高 ， 易 于 修改 ， 那 么 软 
件 维护 起 来 也 比较 简单 ， 代 码 的 运行 速度 也 会 变 快 。 


过量 自 动 化 、 锥 形 化 、 模 块 化 


具体 来 说 ,我 们 应 采取 以 下 行动 。 
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e 懒惰 
让 重复 的 工作 结构 化 。 
对 于 手动 作业 ， 我 们 应 先 写 代码 ， 再 做 工具 ， 最 后 实现 自动 化 。 
注意 ， 不 能 一 上 来 就 追求 自动 化 。 先 明确 手动 作业 的 流程 ， 再 将 
能 自动 化 的 部 分 自动 化 ， 这 样 做 的 效率 比较 高 。 在 进行 自动 化 之 
前 ， 要 先 找 出 自动 化 效果 最 好 的 地 方 。 不 管 什么 时 候 ， 只 要 有 重 
复 的 工作 ， 就 可 以 考虑 使 用 工具 实现 自动 化 。 
另外 ， 结 构 化 也 适用 于 文档 。 文 档 创建 好 之 后 ， 我 们 可 以 保留 它 
的 格式 ， 以 便 重 复 使 用 。 这 里 要 注意 的 是 不 要 去 整理 文档 。 保 证 
文档 能 够 被 搜索 到 才 是 我 们 需要 重视 的 地 方 。 所 以 ， 我 们 要 把 搜 
索 文档 时 可 能 用 到 的 关键 字 尽 量 添加 到 文档 的 内 容 或 名 称 中 。 相 
较 于 在 分 好 类 的 文件 夹 中 进行 搜索 ， 全 文 搜索 的 效率 更 高 。 


e 急躁 

我 们 在 工作 时 要 预想 哪些 问题 会 发 生 。 提 前 思考 软件 的 哪些 部 分 
可 能 会 出 现 需 求 ， 在 客户 提出 意见 之 前 做 好 应 对 的 准备 。 

此 时 重要 的 是 分 清 软 件 可 能 被 修改 的 部 分 与 不 会 被 修改 的 部 分 ， 让 
可 能 被 修改 的 部 分 保持 足够 的 灵活 性 。 以 不 发 生 改 变 的 部 分 为 基础 
创建 禹 形 ， 对 会 发 生变 化 的 部 分 做 变量 化 处 理 ， 保 证 能 自由 修改 。 

不 过 ， 用 户 是 任性 的 ， 他 们 的 需求 五 花 八 门 。 全 部 满足 这 些 需求 显然 不 
现实 。 此 时 我 们 可 以 更 急躁 一 点 ， 通 过 设置 文件 来 让 用 户 自 定义 软件 。 


e 傲慢 

自己 做 的 工作 要 能 拿 得 出 手 ， 维 护 要 无 愧 于 人 。 对 自己 写 的 软件 
应 抱 有 专家 意识 ， 保 证 维护 能 轻松 进行 。 

此 时 重要 的 是 要 按照 功能 对 写 好 的 软件 进行 模块 化 管理 。 这 样 ， 在 
开发 其 他 软件 时 ， 我 们 就 可 以 重复 使 用 这 种 按 功能 整合 的 模块 了 。 


ES 后 后 蛋 高 强度 工作 对 程序 员 而 言 没有 意义 
在 职业 美德 中 ， 经 常会 出 现 “拼命 “忘我 ”等 表达 高 强度 工作 的 
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词语 。 但 是 对 程序 员 而 言 ， 高 强度 工作 是 没有 意义 的 。 

不 可 和 否认， 长 时 间 泡 在 办 公 室 里 会 让 人 陷入 一 种 自己 为 项 目 做 出 了 
很 多 贡献 的 错觉 。 其 他 人 也 会 有 相同 的 感受 。 然 而 事实 恰好 相反 ,我们 
越 削减 自己 在 工作 上 花费 的 时 间 和 精力 ， 对 项 目的 实际 贡献 就 越 大 。 
编程 是 一 种 干 到 老 学 到 老 的 工作 。 随 着 工作 经 验 的 积累 ， 程 序 员 对 
问题 领域 的 理解 会 逐步 加 深 ， 实 现 相 同 目 标 所 花费 的 时 间 与 精力 会 慢 慢 
减少 。 只 要 在 工作 中 注意 哪些 地 方 浪费 了 时 间 ， 并 将 经 验 运用 到 下 一 项 
工作 中 去 ， 就 能 实现 工作 的 效率 化 。 

男 外 ， 编 程 是 一 种 高 度 的 脑力 劳动 ， 加 班 带 来 的 恶劣 影响 要 和 远 远 超 
过 我 们 得 到 的 东西 。 编 写 高 质量 的 代码 需要 集中 注意 力 ， 拖 着 疲惫 的 身 
躯 是 写 不 出 好 代码 的 。 

再 者 ， 我 们 在 身体 状态 不 佳 时 容易 迁怒 于 人 ， 把 所 有 的 过 错 都 推 给 
别人 ， 觉 得 自己 是 受害 者 。 这 样 一 来 ， 人 际 关 系 就 会 恶化 ， 团 队 氛 围 会 
变 得 越 来 越 差 。 这 对 团队 、 成 员 以 及 即将 发 布 的 成 品 来 说 ， 都 是 很 大 的 
打击 。 就 算 这 种 情况 只 是 暂时 的 ， 我 们 也 需要 花费 一 些 时 间 来 摆脱 这 种 
状态 。 

自己 拼命 工作 也 好 ， 外 人 施加 压力 也 好 ， 都 不 能 帮助 我 们 提升 大 脑 
的 工作 效率 。 在 脑力 劳动 方面 ， 工 作 时 间 与 劳动 成 果 并 不 成 正比 。 
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童子 军 规则 


英 语 Boy Scout Rule 





“打扫 ” 完 代码 再 离开 


美国 童子 军 有 一 项 很 简单 的 规则 ， 那 就 是 “离开 自己 所 在 的 地 方 
时 ， 这 个 地 方 必须 比 来 时 更 干净 ”"。 就 算 弄 脏 露 营 场 地 的 不 是 自己 ,也 
必须 打扫 干净 再 离开 。 

这 个 规则 同样 适用 于 编程 。 在 离开 之 前 ， 要 让 代码 变 得 比 自己 来 时 
更 整洁 。 代 码 最 初 是 谁 写 的 并 不 重要 ， 重 要 的 是 我 们 要 努力 改善 它 。 



































IE 抑制 代码 腐烂 


代码 必须 时 刻 保 持 精简 。 

然而 在 现实 中 ， 代 人 码 常 常会 随 着 时 间 的 流逝 逐渐 腐 尾 ， 质 量 越 来 越 
差 。 编 写 代码 时 如 果 太 过 随意 ， 就 会 招来 这 种 后 果 。 我 们 必须 阻止 这 种 
情况 发 生 。 

如 果 所 有 人 都 能 遵守 “改善 完 代码 再 离开 ”这 样 一 个 简单 的 规则 ， 
系统 的 质量 就 不 会 恶化 下 去 ， 甚 至 有 可 能 会 慢 慢 提升 。 该 规则 还 有 助 于 
培养 程序 员 的 大 局 观 ， 促 使 程序 员 着 眼 于 整个 软件 的 质量 。 

我 们 只 能 通过 阅读 源 代码 来 掌握 软件 的 行为 。 代 码 就 是 一 切 。 程 序 
员 的 任务 就 是 不 断 改善 代码 。 
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过量 代码 要 改善 之 后 再 提交 


对 于 代码 ， 我 们 要 养 成 先 改善 再 提交 的 习惯 。 这 也 有 助 于 保持 代码 
简洁 。 

笔者 没有 夸大 其 词 。 量 变 会 引起 质变 。 

我 们 的 目标 不 是 在 提交 之 前 让 所 有 代码 都 变 得 完美 ， 而 是 让 代码 比 
之 前 更 优质 一 点 。 我 们 可 以 对 代码 进行 各 种 各 样 的 改善 ， 比 如 调整 变量 
名 、 分 割 大 函数 、 去 除 重复 、 缩 减 条 件 语句 、 取 消 循环 引用 、 通 过 添加 
接口 让 使 用 方法 和 实现 方法 分 离 等 。 不 管 改 善 了 什么 ， 改 善 了 多 少 ， 都 
没有 关系 。 


























局 二 汪汪 编程 讲究 “ 稳 中 求 胜 ” 





在 软件 开发 中 ， 相 比 抄 近 道 节 约 时 间 与 成 本 ， 绕 远道 追求 质量 能 获 
得 更 好 的 结果 。 童 子 军 规则 也 说 明了 这 一 点 。 凡 是 跟 代码 有 关 的 问题 ， 
只 要 选择 抄 近 道 ， 在 维护 阶段 必然 会 产生 不 必要 的 成 本 。 
比如 以 下 几 种 情况 。 











e 在 无 法 直接 获取 价值 的 情况 下 ， 省 去 单元 测试 

按照 这 种 方式 写 出 来 的 软件 以 后 将 很 难 修改 。 因 为 在 修改 的 时 
候 ， 我 们 无 法 确定 这 么 改 是 不 是 有 问题 。 即 便 是 一 处 微小 的 修 
改 ， 也 需要 我 们 手动 进行 测试 。 因 此 ， 软 件 变 得 十 分 脆弱 ， 维 护 
成 本 也 大 幅 提高 。 

设计 本 身 也 是 如 此 。 与 考虑 了 测试 的 设计 相 比 ， 没 有 考虑 测试 的 
设计 因为 没有 研究 使 用 方法 ， 所 以 不 存在 什么 优势 。 


e 为 削减 成 本 ， 强 行使 用 与 目的 不 符 的 现 有 系统 
强行 使 用 与 目的 不 符 的 系统 会 让 我 们 在 编程 的 时 候 感到 痛苦 。 使 
用 这 样 的 系统 早晚 会 出 问题 。 到 头 来 我 们 还 是 得 按照 需求 重新 设 
计 架 构 。 
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此 时 的 成 本 与 正常 开发 需要 的 成 本 相 比 不 但 没有 减少 ， 反 而 因为 
返工 而 大 幅 增 加 了 。 


e@ 发 现 选 了 不 合适 的 库 却 不 进行 处 理 
随 着 需求 的 增加 ， 为 了 隐藏 库 中 不 合适 的 部 分 ， 我 们 需要 额外 添 
加 层次 。 而 每 添加 一 个 层次 ， 分 离 层 次 的 难度 都 会 进一步 增加 。 
这 样 一 来 ， 软 件 不 可 能 进一步 得 到 优化 。 
抄 近 道 的 地 方 一 旦 成 了 新 增 功能 的 基础 ， 之 后 的 修改 操作 就 会 产 
生 巨 大 的 成 本 。 





可 见 ， 欲 速 则 不 达 。 
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性 能 调 优 的 仍 言 


英 语 Proverb ofperformance tuning 





“好 ”的 代码 胜 过 “ 快 ”的 代码 


所 谓 性 能 调 优 ， 就 是 编写 运行 速度 快 的 代码 。 性 能 调 优 也 称 为 代码 
优化 。 

很 多 人 认为 加 快 代码 的 运行 速度 是 一 件 好 事 。 但 实际 上 ， 过 早 优化 
代码 会 产生 各 种 问题 。 

因此 ， 对 于 代码 优化 ， 我 们 要 遵守 以 下 规则 。 




















人 不 要 在 编程 之 初 就 对 代码 进行 优化 
@ 编程 之 初 暂 时 不 要 对 代码 进行 优化 (适用 于 专家 ) 














代码 优化 并 不 是 我 们 在 编程 之 初 就 应 该 考虑 的 事情 。 在 编程 时 ， 我 
们 要 注意 的 是 代码 的 正确 性 和 可 读 性 ， 编 写 高 质量 的 代码 ， 而 不 是 想 方 
设法 让 代码 的 运行 速度 变 快 。 

































































“ 快 ”的 代码 得 不 偿 失 


优化 代码 需要 我 们 付出 无 法 接受 的 代价 。 即 便 完成 优化 ， 代 码 也 会 
失去 一 些 重要 的 东西 ， 比 如 以 下 几 点 。 











。 可 读 性 变 低 
优化 后 的 代码 肯定 比 优化 前 的 代码 更 难 懂 。 
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因为 从 性 质 上 来 说 ， 优 化 所 做 的 工作 是 修改 代码 中 原本 简单 直接 
的 逻辑 。 优 化 代码 后 ， 逻 辑 不 再 简单 明快 ， 交 得 难以 表达 意图 。 
也 就 是 说 ， 要 提高 性 能 ， 必 须 以 失去 逻辑 清楚 的 设计 和 降低 代码 
的 可 读 性 为 代价 。 

最 大 限度 优化 过 的 代码 非常 难看 ， 我 们 很 难 掌 握 它 的 处 理 过 程 。 


质量 变 差 

代码 复杂 化 会 导致 代码 的 可 读 性 下 降 ， 从 而 降低 代码 的 质量 。 在 
没有 明确 描述 算法 过 程 的 代码 中 ， 故 障 很 容易 被 汤 掉 。 

不 论 回答 的 速度 有 多 快 ， 答 不 出 正确 答案 也 枉然 。 说 得 讽刺 一 
点 ， 优 化 在 给 代码 加 入 难以 发 现 的 新 缺陷 方面 算是 一 种 切实 有 效 
的 方法 。 


复杂 度 增 大 

优化 会 利用 特殊 的 后 门 强化 模块 间 的 依赖 性 ， 提 升 代 码 的 结合 
度 ， 让 代码 能 够 利用 一 些 平台 固有 的 功能 。 

用 如 此 取 巧 的 方式 编写 代码 会 增加 代码 的 复杂 度 ， 同 时 让 代码 失 
去 可 移植 性 。 

慢 慢 地 ， 代 码 将 越 来 越 不 符合 优质 代码 的 条 件 。 


阻碍 维护 

代码 复杂 化 导致 代码 的 可 读 性 下 降 ， 从 而 提升 了 维护 代码 的 
难度 。 

首先 ， 问 题 难以 被 发 现 ， 因 为 代码 优化 之 后 ， 不 自然 的 描述 会 增 
加 。 这 样 一 来 ， 我 们 就 很 难 追 踪 处 理 的 流程 了 。 也 就 是 说 ， 优 化 
后 的 代码 是 高 风险 的 危险 代码 。 

再 者 ， 优 化 还 会 对 代码 的 可 扩展 性 产生 不 好 的 影响 。 优 化 是 在 给 
代码 设置 更 多 前 提 条 件 的 基础 上 实现 的 。 因 此 ， 优 化 会 限制 代码 
的 通用 性 和 可 扩展 性 。 


a 


在 大 多 数 情况 下 ， 优 化 只 能 在 特定 的 环境 中 发 挥 作 用 。 在 某 个 特 
ee 


会 变 低 。 
比如 我 们 针对 某 


工作 量 增多 


个 特定 种 类 的 处 理 器 选用 了 最 合适 的 数据 类 型 。 
这 种 做 法 就 可 能 会 导致 软件 在 其 他 处 理 器 上 执行 的 速度 变 慢 。 


对 代码 进行 优化 就 等 于 多 加 了 一 项 工作 。 
程序 员 要 做 的 工作 非常 多 。 
该 先 去 处 理 其 他 紧急 的 工作 ， 而 不 是 去 对 代码 进行 优化 。 

优化 是 一 项 非常 耗 时 的 工作 。 找 到 问题 出 现 的 原因 并 对 代码 进行 
优化 并 不 是 一 件 容 易 的 事情 。 一 旦 弄 错 优化 对 象 ， 就 会 浪费 大 量 


宝贵 的 劳力 。 


代码 如 果 能 成 功 运行 起 来 ， 我 们 就 应 


(si 袍 先 写 高 质量 的 代码 


我 们 要 先 写 高 质量 的 代码 ， 然 后 根据 需要 进行 优化 。 





高 质量 的 代码 是 在 信 ， 








息 隐 藏 的 原则 下 写 出 来 的 。 因 为 各 个 决定 只 会 


在 局 部 范围 产生 影响 ， 所 以 代码 的 修改 不 会 影响 到 其 他 部 分 。 先 写 高 质 
ee 





况且 在 大 多 数 情况 下 








上 述 优先 顺序 写 出来 的 代 本 只 


会 产生 多 少 新 的 工作 。 而 | 
一 些 。 


人 





0 与 “高 性 能 ”并 不 矛盾 。 按 照 
高 质量 代码 的 要 求 ， 优 化 时 就 不 
， 我 们 在 做 添加 工作 时 也 会 轻松 
































另外 ， 写 完 高 质量 的 代码 之 后 ， 如 果 要 进行 优化 ， 一 定 要 思考 其 必 
要 性 。 优 化 在 很 多 时 候 不 值得 我 们 花费 那么 多 的 时 间 和 成 本 。 是 否 进行 


优化 ， 要 在 与 解决 故障 、 
再 决定 。 


添加 


新 功 角 














bE 和 发 布 产 品 等 重要 工作 相 比 较 之 后 
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局 5 软件 的 性 能 


从 整体 来 看 ， 除 了 代码 ， 软 件 的 性 能 还 受到 很 多 因素 的 影响 。 比 如 
以 下 几 个 因素 。 


@ 执行 环境 

@ 部 署 的 设置 或 者 安装 的 设置 
@ 使 用 的 中 间 件 

@ 使 用 的 库 

@ 相互 运用 的 旧 系 统 


@ 架构 


这 样 一 看 ， 一 行 一 行 的 代码 对 软件 整体 的 影响 十 分 渺小 。 除 了 各 行 
代码 之 外 ， 还 有 很 多 影响 性 能 的 因素 。 


架构 的 性 能 

在 设计 架构 时 ， 有 时 我 们 也 需要 把 性 能 考虑 进去 。 

这 是 因为 架构 的 影响 范围 很 广 ， 后 期 发 现 问题 很 难 修改 。 比 如 在 设 
计 通 信 协 议 时 就 要 尽量 避免 影响 性 能 。 

我 们 应 当 尽 早 对 这 些 地方 进 行 性 能 测试 。 这 样 既 可 以 不 断 完善 测试 
环境 ， 又 能 尽早 发 现 性 能 问题 ， 抑 制 成 本 上 涨 。 

另外 ， 早 期 的 性 能 测试 需要 持续 进行 下 去 ， 因 为 这 么 做 能 使 我 们 清 
楚 地 看 到 修改 哪里 会 严重 影响 性 能 。 如 此 一 来 ， 当 出 现 性 能 问题 时 ,我 
们 就 不 用 调查 整个 架构 ， 只 看 最 近 添 加 的 修改 即 可 。 

















局 二 天 性 能 调 优 的 流程 





在 实际 工作 中 ， 很 多 时 候 我 们 会 因为 软件 的 特性 而 需要 对 代码 进行 
优化 。 
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在 对 代码 进行 优化 (性 能 调 优 ) 时 ， 我 们 需要 在 流程 方面 遵守 几 项 
规则 。 











e 证 明 优化 的 必要 性 
首先 要 再 三 确认 优化 的 必要 性 。 有 时 候 用 户 对 某 部 分 性 能 的 需求 
并 没有 程序 员 想 的 那么 高 。 


e 测量 性 能 ， 找 出 瓶颈 

确认 需要 优化 后 ， 我 们 要 先 找 出 瓶颈 所 在 。 

性 能 出 现 问题 并 不 代表 所 有 代码 的 运行 速度 都 很 慢 ， 大 多 是 某 个 
特定 部 分 占用 了 较 长 时 间 。 这 个 占 去 大 部 分 处 理 时 间 的 部 分 称 为 
“热点 ”。 

我 们 要 全 身心 地 寻找 这 个 热点 。 


e 优化 瓶颈 部 分 的 代码 
发 现 热 点 之 后 要 对 其 进行 修改 。 


e 测量 性 能 ， 确 认 优 化 效果 
不 管 是 代码 优化 前 还 是 代码 优化 后 ， 我 们 都 必须 对 性 能 进行 


测量 。 
性 能 差 的 部 分 是 无 法 推测 出 来 的 。 优 化 的 效果 也 只 能 通过 测量 
得 知 。 


e 验证 优化 后 的 代码 是 否 存在 运行 问题 
优化 可 能 会 使 代码 出 现 一 些 新 的 问题 。 对 代码 进行 优化 后 ， 必 须 
认真 检查 代码 是 否 存 在 运行 问题 。 








这 里 再 说 一 下 寻找 热点 的 方法 。 寻 找 热 点 时 ， 应 利用 分 析 工 具 ， 尽 
可 能 仔细 且 准 确 地 检查 代码 。 

另外 ， 由 于 优化 过 程 中 要 多 次 对 代码 的 性 能 进行 测量 ， 所 以 为 了 提 
高 效率 ， 我 们 最 好 对 这 部 分 工作 执行 自动 化 处 理 。 























233 





出 处 
[1] 松本 行 弘 . 松本 行 弘 的 程序 世界 [M]. 柳 德 燕 ， 李 黎明 , 夏 倩 , 张 文 旭 , 译 . 
北京 : 人 民 邮 电 出 版 社 , 2011. 





























相关 图 书 

1] 约 书 亚 : 布 洛克 . Effective Java 中 文 版 ( 第 3 版 ) [M1]. 命 黎 敏 , 译 . 北 
京 : 机 械 工 业 出 版 社 , 2018. 

有 汽 诚 . 夕 又 一 又 先生 7 口 分 了 人 论 [M]. 东京 : 共立 出 版 , 1991. 

3] 皮特 ' 古 德 利 弗 . 编程 折 艺 一 一 编写 卓越 的 代码 [M]. 韩 江 , 陈 玉 , 译 . 北 
京 : 电子 工业 出 版 社 , 2008. 

布 莱 恩 ' 柯 尼 汉 , 罗 勃 ， 派克 . 程序 设计 实践 [M]. 北京 : 人 民 邮 电 出 版 社 ， 
2016. 























人 





































































































入 




















234 


无 我 编程 


莫 语 Egoless programming 





CA 舍弃 自我 


在 编程 的 过 程 中 应 舍弃 自我 。 

具体 来 说 ， 就 是 舍弃 “自负 ”与 “自尊 ”， 与 其 他 成 员 合作 。 
地 把 自己 写 的 代码 给 别人 看 ， 请 别人 提出 意见 。 

看 代码 的 人 和 把 代码 给 别人 看 的 人 都 应 抛弃 “自己 更 优秀 ”的 自尊 
心 ， 双 方 都 应 纯粹 为 创造 出 更 好 的 东西 而 交流 。 写 代码 时 不 要 炫 漆 自 己 
的 能 力 ， 应 将 注意 力 放 在 写 出 更 好 的 代码 上 。 

















ELA 汪 抛弃 自我 ， 提 升 质 量 


程序 员 常 把 自己 写 的 代码 当成 私有 物品 ， 讨 大 别人 指出 代码 中 的 故 
障 以 及 缺陷 。 

但 是 ， 把 代码 拿 给 同事 看 ， 虚 心 接受 对 方 的 建议 ， 这 种 开发 方式 更 
有 利于 提升 软件 的 质量 ， 也 有 利于 营造 更 好 的 团队 氛围 ， 提 升 团 队 成 员 
的 编程 水 平 。 








二 遵守 无 我 编程 的 十 斌 





我 们 在 写 代 码 时 要 将 下 述 “ 无 我 编程 的 十 诚 ” 放 在 心头 。 


@ 理解 并 接受 自己 也 会 犯错 的 事实 
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e@ 你 不 同 于 你 的 代码 

@ 人 外 有 人 天 外 有 天 

@ 不 要 在 没有 沟通 的 情况 下 重 写 代 码 

@ 对 技 不 如 己 者 要 苯 施 ,并 且 有 耐心 

@ 世上 唯一 不 变 的 就 是 变化 

@ 真正 的 权威 来 自 知识 而 不 是 地 位 

@ 为 信仰 而 战 ， 但 也 要 坦诚 面 对 失 败 

@ 不 能 闭门造车 

@ 宽 待 他 人 ， 严 待 代码 ， 批 评 的 对 象 是 代码 而 不 是 人 


和 下 的 


无 我 地 进行 编程 是 好 事 ， 但 自我 也 是 人 不 可 或 缺 的 一 种 品质 。 将 自 
我 与 工作 完全 分 离 是 一 件 非常 困难 的 事 。 而 且 ， 自 我 是 完成 所 有 事情 的 
原动力 ， 人 只 有 有 了 自我 才能 高 效 地 工作 。 

单方 面 扼杀 自我 ， 牺 牲 自己 为 他 人 和 团队 服务 ， 是 一 种 “Win- 
Lose”(〈 一 方 赢 ， 一 方 输 ) 的 行为 。 随 性 而 为 并 不 好 ， 但 扼杀 自我 也 不 
会 对 团队 有 任何 贡献 。 

我 们 要 控制 好 自我 的 度 。 
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一 步 一 步 走 


英 语 One by one 





出 循序 渐进 








编程 时 要 一 次 只 做 一 件 小 事 。 
件 一 件 做 ， 一 点 一 点 来 ， 就 像 上 台阶 一 样 一 步 一 步 走 。 不 要 一 次 
性 处 理 多 项 工作 。 

完成 一 个 小 任务 后 认真 检查 ， 没 有 问题 后 再 开始 下 一 个 任务 ， 如 此 
循环 。 














“步步为营 ”更 有 效率 


一 次 处 理 一 项 工作 的 工作 方式 更 有 效率 ， 最 终 产 品 的 质量 也 更 好 。 

之 所 以 这 么 说 ， 是 因为 一 次 性 处 理 多 项 工作 容易 让 这 些 工 作 混成 一 
团 ， 最 后 哪个 都 处 理 不 好 。 就 算 不 会 造成 大 问题 ， 两 项 工作 混在 一 起 也 
会 使 代码 质量 下 降 ， 在 时 间 上 造成 浪费 。 

一 步 一 步 进行 编程 ， 最 后 一 步 操作 撤销 起 来 也 会 比较 容易 。 

当 发 生 问题 需要 回 滚 的 时 候 ， 如 果 前 面 坚持 一 步 一 步 地 完成 工作 ， 
回 深 起 来 就 会 很 简单 。 只 要 把 顺序 反 过 来 ， 一 步 一 步 走 回去 即 可 。 

比如 我 们 现在 只 想 删除 类 A， 但 类 A 和 类 B 的 结果 在 代码 中 混成 
一 团 。 此 时 在 不 影响 类 B 的 情况 下 回 深 类 A 就 会 非常 困难 。 

一 步 一 步 进行 编程 ， 工 作 检查 起 来 也 比较 简单 。 

比如 在 写 新 的 函数 时 ， 即 使 该 函数 还 没有 被 任何 地 方 引 用 ,我 们 也 
能 先 通 过 编译 来 检查 该 函数 是 否 存 在 语法 错误 。 男 外 ， 我 们 也 可 以 通过 
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单元 测试 检查 运行 方面 是 否 有 问题 。 这 样 可 以 让 计算 机 帮 有 我 们 做 不 少 
工作 。 

一 步 一 步 进 行 编程 ， 新 旧 代码 的 替换 也 会 更 安全 。 

在 这 种 情况 下 ， 我 们 不 必 一 次 性 推翻 所 有 代码 ， 然 后 全 部 重 写 。 不 妨 
在 保证 运行 的 状态 下 添加 新 代码 ， 当 新 代码 能 完全 代替 旧 代 码 时 ， 再 一 次 
性 推翻 所 有 旧 代码 。 这 个 方法 虽然 听 上 去 很 麻烦 ， 但 失败 的 风险 要 小 许多 。 

为 什么 要 一 步 一 步 进 行 编程 呢 ? 除了 实用 性 方面 的 原因 ， 这 与 心理 
因素 也 有 一 定 关系 。 

步 一 步 编程 意味 着 程序 员 能 够 掌握 和 控制 代码 的 状态 。 这 样 做 能 

去 除 不 确定 因素 ， 让 人 安心 工作 。 

在 有 心理 压力 时 ， 人 很 难 像 平时 一 样 做 出 准确 的 判断 。 控 制 好 自己 
的 状态 也 是 写 出 优质 代码 的 必要 条 件 之 一 。 












































怎么 做 一 次 性 处 理 多 项 工作 


工作 要 一 点 一 点 做 。 
ts 当 我 们 需要 在 模块 间 移 动 函 数 时 ， 即 便 发 现 函 数 名 不 
， 也 不 要 在 移动 函数 的 过 程 中 修改 函数 名 。 正 确 的 做 法 是 等 函数 移 
en 确认 运行 没有 问题 之 后 ， 再 着 手 修改 函数 名 。 
在 测试 驱动 开发 中 ,不 要 一 口气 写 完 所 有 代码 后 再 进行 测试 。 当 
然 , 也 不 能 先 写 完 所 有 的 测试 代码 ， 再 写 正式 代码 。 应 该 先 写 一 点 测试 
代码 再 写 一 点 正式 代码 ， 如 此 循环 。 


关联 信息 7E 思考 也 要 一 步 一 步 站 7 一 点 一 点 想 


聪明 的 人 常 给 人 一 种 不 用 思考 就 能 说 出 答案 的 感觉 
实 ， 聪 明 的 人 不 仅 输出 速度 快 ， 正 确 率 还 高 ， 仿 佛 知道 这 其 中 的 
捷径 。 其 实 并 非 如 此 。 

聪明 的 人 并 不 是 用 特殊 的 方法 跳 过 中 间 步 又 来 加 快 思考 速度 的 。 他 
们 也 需要 一 步 一 步 进行 思 考 ， 只 不 过 这 些 人 会 在 脑 中 搭建 逮 辑 步 又 ， 每 
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一 步 的 
当 


步 又 来 ， 














思考 都 快速 旦 准确， 所 以 整体 看 起 来 才 又 快 又 准 。 
不 能 一 下 子 想 出 答案 时 ， 我 们 不 能 怪 自己 脑子 不 好 。 要 扎实 地 按 
一 点 一 点 地 进行 思考 。 

















逻辑 思考 的 秘 雇 























关于 逻辑 思考 ， 有 几 个 关键 点 需要 我 们 了 解 。 
@ 想 立 刻 获 得 答案 的 态度 是 不 正确 的 。 一 眼看 不 出 答案 时 应 当 继 续 
思考 
@ 没有 经 过 深思 熟 虑 就 下 结论 的 做 法 是 错误 的 。 发 现 某 个 东西 可 以 
满足 条 件 时 不 能 想当然 ， 要 探讨 其 他 的 可 能 性 
@@ 避免 反复 思考 同一 件 事 
@ 直接 用 脑子 思考 有 些 困难 ， 不 如 边 写 边 思考 。 边 写 边 思 考 能 产生 
额外 的 效果 。 对 于 想 不 明白 的 地 方 ， 有 时 候 写 下 来 一 看 就 明白 了 
@ 直觉 对 逻辑 思考 来 说 也 很 重要 。 比 如 ， 当 我 们 感 党 “创建 答 阵 有 
助 于 整理 信息 ”时 ， 不 妨 先 试 一 试 。 不 过 ， 直 觉 只 能 用 在 思考 的 
过 程 中 。 仅 赁 直觉 来 获取 答 这 可 不 是 一 
个 好 习惯 
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TMTOWTDI 


英 语 There’s more than one way to do 站 


中 文 做 法 不 止 一 个 





工具 具备 多 样 性 是 好 事 


我 们 在 设计 拿 给 别人 用 的 工具 ( 编程 语言 、DSL 和 API) 时 ， 要 想 
办 法 让 工具 具备 多 样 性 。 

这 样 一 来 ， 虽 然 工具 本 身 会 变 得 复杂 ， 但 不 管 在 什么 样 的 情况 下 ， 
使 用 工具 的 人 都 不 需要 写 复杂 的 代码 。 
































对 象 多 样 方法 也 应 多 样 








现实 是 复杂 的 。 自 然 语 言 之 所 以 复杂 ， 是 因为 要 应 对 现实 。 自 然 语 
言 之 所 以 能 使 现实 简单 化 ， 是 因为 自然 语言 本 身 是 复杂 的 。 正 因为 自然 
语言 复杂 ， 它 才能 描述 复杂 的 现实 世界 。 

软件 在 本 质 上 也 是 复杂 的 。 所 以 ， 工 具 作 为 软件 ， 也 应 该 设计 得 复 
杂 一 些 。 

虽然 方法 越 少 给 人 的 感觉 越 简 单 ， 但 要 想 简 单 地 描述 诸多 复杂 的 对 
象 ， 工 具 最 好 拥有 一 定 的 复杂 性 及 多 样 性 。 

















VA; 二 多 准备 一 些 方法 


在 设计 工具 时 ， 要 多 准备 几 个 方法 。 要 以 “简单 的 事情 简单 做 ， 复 
杂 的 事情 也 能 做 ”为 目标 。 
对 使 用 者 来 说 ， 选 项 增多 意味 着 需要 花 更 多 的 时 间 去 熟悉 工具 。 不 


























240 





过 熟悉 之 后 ， 使 用 者 就 能 灵活 使 用 工具 了 。 这 时 ， 他 们 就 知道 如 何 从 多 
个 选项 中 选 出 最 符合 当前 情况 的 选项 了 。 

工具 由 于 其 性 质 ， 使 用 的 时 间 远 比 编写 的 时 间 长 。 因 此 ， 用 在 完善 
工具 上 的 投资 是 有 杠杆 效应 的 。 即 便 在 设计 上 花费 了 很 多 时 间 ， 只 要 能 
做 出 一 个 好 的 工具 ， 我 们 就 能 得 到 无 穷 大 的 回报 。 


TMTOWTDI 与 简单 性 


对 软件 而 言 ， 简 单 性 的 优先 级 很 高 。 不 过 ， 简 单 性 应 该 放 在 哪里 
呢 ? 对 于 这 个 问题 ， 我 们 就 需要 从 整个 软件 的 角度 来 考虑 了 。 

TMTOWTDI 认 为， 在 工具 类 软件 的 情况 下 ， 工 具 方 应 承担 复 林 性， 
简单 性 应 留 给 用 户 方 。 

在 其 他 情况 下 我 们 也 不 应 该 一 味 追 求 简单 性 。 在 某 些 情况 下 要 对 复 
杂 性 持 有 宽容 的 态度 ， 以 优化 生态 系统 整体 为 先 。 
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第 6 章 手法 E 


~ 程序 员 的 工具 箱 ~ 


只 有 脚踏实地 进行 实践 才能 从 义务 的 
重担 下 解放 我 们 自己 。 


一 一 歌德 





电光 弹 


英 语 Tracer ammunition 


留 在 最 终 代码 里 的 “骨骼 代码 ” 


忠 光 弹 是 一 种 会 发 光 的 子弹 ,能 让 人 看 清 其 飞行 轨迹 。 在 弹 带 上 ， 








每 隔 几 发 普通 子弹 就 会 装填 一 发 目光 弹 。 
息 光 弹 会 立刻 给 我 们 反馈 。 忠 光 弹 发 射 后 ,会 像 烟花 一 样 描绘 出 从 
枪 口 到 着 弹 点 的 弹道 ， 帮 助 我 们 在 射击 过 程 中 修正 瞄准 位 置 。 








者 的 偏差 被 抑制 至 
中 目标 。 





























因为 目光 弹 与 普通 子弹 在 同一 环境 下 发 射 ， 所 以 外 部 因素 造成 的 二 


1 了 最 小 。 忠 光 弹 能 命中 目标 ， 意 味 着 普通 子弹 也 能 命 


同样 ， 在 编程 过 程 中 ,我们 也 需要 打出 “上 忠 光 弹 ” 来 捕捉 目标。 
编程 中 的 忠 光 弹指 先 对 那些 想 要 优先 检验 的 部 分 进行 编程 。 此 时 我 
们 可 以 编写 简单 的 端 对 端 软件 。 软 件 只 要 能 在 实际 环境 下 运行 并 进行 检 











验 即 可 。 



































这 里 编写 的 其 实 是 成 品 软件 的 框架 。 编 写 的 代码 都 是 正式 代码 ， 它 
们 之 后 会 通过 项 目 不 断 变 得 丰满 ， 最 终 存留 在 成 品 软件 之 中 。 














XUEA 汪 在 黑暗 中 照 亮 道路 





忠 光 弹 由 于 能 与 普通 子弹 在 同一 环境 、 同 一 制约 条 件 下 发 射 ， 所 以 
所 获取 的 信息 的 准确 性 较 高 。 由 此 ， 我 们 便 可 以 立刻 获得 正确 的 反馈 ， 








准确 捕捉 到 目标 。 
要 想 在 软件 姑 
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从 成 本 的 角度 来 看 ， 这 也 是 比较 廉价 的 一 种 方案 。 
F 发 中 获得 同样 的 效果 ， 就 需要 以 迅速 且 能 看 得 到 的 形 








式 多 次 提示 与 软件 最 终 形态 有 关 的 决策 。 所 以 ,我 们 需要 有 正式 的 软件 。 





必 


特别 是 在 从 零 开 发 软件 时 ， 程 序 员 必须 像 枪手 一 样 在 黑暗 中 锁定 目 


标 ， 因 为 在 没有 系统 的 情况 下 ， 用 户 的 需求 会 变 得 模糊 。 程 序 员 自 己 在 
F 发 软件 时 也 要 面 对 生 朴 的 算法 、 开 发 技巧 、 语 言 和 库 等 。 而 且 ， 如 果 























项 目 耗 时 过 长 ， 情 况 与 目的 等 也 很 有 可 能 发 生变 化 。 


在 这 种 情况 下 ， 使 用 种 光 弹 能 获得 以 下 好 处 。 


e 能 得 到 用 户 的 反馈 
在 使 用 旭光 弹 的 情况 下 ， 我 们 可 以 提早 把 软件 展示 给 用 户 。 只 要 
交流 得 当 ， 我 们 就 能 从 用 户 那里 得 到 有 用 的 信息 。 
用 户 能 告诉 我 们 功能 方面 有 哪些 不 足 。 看 着 软件 一 步 步 完成 ， 他 们 
也 会 感到 高 兴 。 用 户 参 与 到 项 目 之 中 ， 对 项 目的 感情 也 日 益 加 深 。 
在 此 过 程 中 ， 用 户 还 会 告诉 我 们 软件 距离 最 终 目 标 还 剩 多 远 。 


能 尽早 为 程序 员 提 供 发 挥 本 领 的 舞台 

没有 什么 比 空 无 内 容 的 说 明 书 更 打击 程序 员工 作 的 积极 性 了 。 在 
这 种 情况 下 ， 我 们 仿佛 置身 于 缺 氧 的 环境 中 。 

尽早 构思 并 实现 软件 的 端 对 端 交互 ， 能 提早 为 程序 员 提 供 发 挥 本 
领 的 狂 台 ， 提 高 全 员 的 工作 效率 。 


能 更 快 、 更 正确 地 进行 测试 和 调试 

在 使 用 旭光 弹 的 情况 下 ， 我 们 能 获得 用 于 整合 代码 的 平台 。 
软件 完成 端 对 端 连 接 ， 就 意味 着 搭建 好 了 能 整合 代码 的 环境 ， 当 
上 日 完成 单 体 测 试 的 代码 可 以 立刻 整合 。 也 就 是 说 ， 整 合 工作 可 以 
分 散 到 每 天 ， 甚 至 可 以 一 天 进行 多 次 。 

这 样 一 来 ， 我 们 就 能 立刻 发 现 新 的 修改 所 带 来 的 影响 ， 修 改 的 相 
互 作用 也 限制 在 了 一 定 范围 内 。 因 此 ， 调 试 与 测试 能 变 得 更 快 和 
更 正确 。 


确保 软件 可 以 演示 
没 人 知道 项 目的 利益 关系 者 哪 天 想 看 演示 。 在 加 入 了 旭光 弹 的 开 
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发 中 ， 我 们 能 获得 可 以 随时 演示 软件 的 环境 。 


e@ 进展 更 加 明确 

在 加 入 了 旭光 弹 的 代码 开发 中 ， 我 们 能 以 用 例 为 单位 进行 开发 。 这 
样 一 来 ， 生 产 率 报告 和 提供 给 用 户 的 进度 报告 都 会 变 得 更 加 明确 。 
另外 ， 由 于 各 个 开发 单位 较 小 ， 所 以 不 会 出 现 巨 大 且 不 可 拆 解 的 
代码 块 。 


过 Ai 恒 先 编写 能 够 运行 起 来 的 基础 部 分 





先 编写 基础 部 分 ,然后 慢 慢 添加 其 他 内 容 。 

基础 部 分 的 代码 要 保持 在 最 小 的 状态 。 不 过 要 注意 ， 这 些 代码 必须 
能 运行 起 来 才 行 。 它 们 最 后 会 成 为 软件 最 终 形态 的 “骨骼 ”的 一 部 分 。 
也 就 是 说 ， 这 些 代码 不 是 用 完 就 扔 的 。 

男 外 ， 在 向 基础 代码 添加 内 容 时 ,一 定 要 检查 添加 的 内 容 是 否 偏离 
了 目标 。 要 时 常 对 添加 的 内 容 进行 检查 ， 并 根据 需要 修正 路 线 。 在 这 种 
开发 模式 下 ， 只 要 捕捉 到 目标 ， 后 面 的 添加 操作 就 会 变 得 非常 简单 。 











| 
































= 与 原型 的 区 别 
蚜 光 弹 的 作用 与 原型 的 作用 类 似 , 但 二 者 有 着 明确 的 区 别 。 


e 原型 

原型 的 作用 是 验证 软件 的 概念 或 最 终 形 态 是 否 在 理解 上 存在 偏 
差 。 因 此 ， 确 认 过 概念 之 后 ， 我 们 会 把 创建 的 东西 全 部 抛弃 ， 然 
后 根据 获得 的 信息 以 正确 的 形式 重新 搭建 软件 。 

假设 我 们 正在 开发 一 个 供 配 送 中 心 使 用 的 软件 。 软 件 中 有 一 个 用 
于 将 大 小 不 一 的 货物 巧妙 装 车 的 功能 。 此 时 有 两 个 问题 需要 解 
决 ， 一 个 是 难以 设计 出 一 目 了 然 的 用 户 接口 ， 另 一 个 是 用 于 得 出 
最 佳 装载 方式 的 算法 太 难 。 
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在 这 种 情况 下 ， 首 先 我 们 要 使 用 能 简单 搭建 画面 的 开发 工具 创建 
出 用 户 接 口 的 原型 。 

原型 中 需要 有 画面 显示 以 及 一 些 模拟 操作 ， 只 要 能 让 终端 用 户 确 
认 使 用 时 的 感觉 即 可 。 当 用 户 按 下 按钮 时 ， 相 应 功能 不 必 真 正 运 
行 起 来 。 我 们 要 通过 原型 找到 能 让 用 户 满意 的 用 户 接口 ， 之 后 将 
原型 抛弃 ， 重 新 编写 代码 。 

同样 ， 我 们 也 要 创建 多 个 装载 算法 的 原型 。 在 需求 上 与 终端 用 户 
达成 一 致意 见 后 ， 按 照 定 下 来 的 算法 重新 编写 代码 。 





电光 弹 

旭光 弹 能 体现 出 软件 内 部 是 如 何 相互 协作 的 。 它 能 为 程序 员 提 供 
可 以 在 今后 一 直 使 用 的 构架 ， 能 为 用 户 展示 使 用 效果 。 

如 果 将 慢 光 弹 用 于 上 述 示例 〈 开 发 供 配送 中 心 使 用 的 软件 ) 中 ， 
就 是 创建 并 整合 简单 且 能 运行 的 用 户 接 口 和 装载 算法 。 虽 然 此 时 
的 代码 还 很 粗糙 ， 但 只 要 把 软件 中 的 所 有 模块 连接 起 来 ， 用 户 和 
程序 员 就 能 获得 基础 框架 。 

随 着 开发 的 进行 ， 新 的 功能 会 不 断 添加 到 框架 中 。 简 陋 的 临时 代 
码 会 被 逐渐 替换 成 正式 代码 。 不 过 ， 框 架 本 身 会 存留 下 来 。 当 初 
创建 出 来 的 代码 是 怎样 运行 的 ， 软 件 就 怎样 运行 。 








总 而 言 之 ， 原 型 生成 的 代码 是 用 完 就 扔 的 。 这 些 代 码 只 是 整体 的 一 
部 分 ， 是 被 临时 拿 来 使 用 的 。 而 种 光 弹 是 最 小 限度 的 可 运行 的 正式 代 
码 ， 是 系统 最 终 形 态 的 “骨髓 ”的 一 部 分 。 这 个 差异 十 分 重要 。 

原型 的 真正 用 途 在 于 “学 习 ”。 原 型 的 价值 不 存在 于 生成 的 代码 
而 存在 于 我 们 得 到 的 教训 里 。 

原型 可 以 说 是 发 射 忠 光 弹 之 前 的 “侦查 活动 ”或 “谍报 活动 ”。 




















蕊 


E33 后 了 由 原型 、 样 品 与 试制 品 








原型 的 真正 用 途 在 于 “学 习 ”。 这 种 “学 习 ” 包 含 两 个 方面 的 内 容 。 
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e@ 用 作 样 品 的 原型 
这 类 原型 主要 用 于 帮助 我 们 准确 掌握 用 户 的 需求 。 我 们 可 以 通过 
让 用 户 使 用 样品 来 确定 需求 。 


e 用 作 试 制品 的 原型 
这 类 原型 用 于 帮助 我 们 摸索 开发 方法 。 
我 们 在 开发 一 种 全 新 类 型 的 软件 时 会 遇 到 很 多 未 知 的 东西 ， 风 险 
很 大 。 因 此 ， 为 了 和 青 清 具体 的 开发 方法 ， 我 们 需要 用 到 原型 。 
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契约 式 设 计 
英 语 Designby Contract 
简 写 DbC 





2 对 调 用 方 与 被 调用 方 的 契约 


函数 是 用 来 做 某 项 工作 的 。 在 开始 某 项 工作 之 前 ， 函 数 要 先 “预想 ”工作 
完成 后 的 状态 ， 在 工作 结束 之 后 ， 要 对 当前 状态 履行 某 种 “约定 ”。 

这 里 的 “预想 ” 称 为 “前 置 条 件 "， 是 函数 调用 方 应 当 遵守 的 契约 。 
而 “约定 ”是 “后 置 条 件 "， 是 函数 方 应 当 遵守 的 契约 。 

这 种 函数 与 函数 调用 方 互相 缔结 小 约 的 编程 方式 ， 称 为 “ 净 约 式 
设计 ”。 

在 契约 式 设 计 中 ， 枯 数 调用 方 需 要 根据 契约 ， 在 调用 本 数 之 前 满足 
前 置 条 件 。 传 递 正确 的 参数 是 函数 调用 方 的 责任 。 

男 一 方面 ， 函 数 方 要 满足 后 置 条 件 。 在 函数 被 调用 之 后 满足 相应 条 
件 是 函数 方 的 责任 。 

如 果 某 项 契约 条 款 未 履行 ， 则 启动 补救 方案 。 具 体 来 说 就 是 抛 出 异 
常 、 终 止 软件 运行 等 。 



































尽早 发 现 理解 上 的 偏差 





严格 遵守 契约 能 获得 以 下 好 处 。 


@ 能 保证 代码 的 正确 性 。 正 确 的 代码 只 会 按照 要 求 做 事 
使 代码 保持 简洁 。 函 数 的 处 理 代码 可 以 在 假设 其 满足 前 置 条 件 


的 前 提 下 编写 


外 
@ 有 
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@ 容易 提早 发 现 问题 。 出 现 无 法 履行 契约 的 情况 就 意味 着 会 有 故障 
发 生 ， 我 们 不 能 视而不见 。 出 现 问 题 时 立刻 让 系统 崩溃 能 降低 排 
查 故障 的 难度 


过 注释 和 断言 缔结 契约 


我 们 要 把 契约 内 容 事先 写 在 函数 的 注释 里 。 
检查 契约 是 否 被 履行 的 代码 要 以 断言 的 方式 编写 。 用 上 断言 检查 前 置 
条 件 与 后 置 条 件 ， 一 旦 发 现 契 约 未 被 履行 则 立刻 终止 软件 。 契 约 式 设 计 
的 处 理 流程 如 下 图 所 示 。 
调用 方 被 调用 方 ( 函数 ) 





























外 部 输入 值 






验证 输入 值 ( 传递 给 函数 的 值 ) 


的 合法 性 


检查 传递 过 来 的 
办 = 
人 值 是 否 符合 契约 











如 果 值 非法 
则 报错 






























函数 本 身 的 处 理 












检查 后 置 条 件 
( asdert ) 























检查 是 否 能 返 
满足 契约 的 值 





























我 们 要 注意 以 下 儿 个 地 方 。 
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e 函数 方 不 调整 参数 

被 调用 的 函数 方 不 可 以 调整 传递 过 去 的 参数 。 比 如 函数 方 在 检查 
参数 时 发 现 参数 不 符合 前 置 条 件 ， 此 时 就 不 能 将 其 转换 为 符合 前 
置 条 件 的 参数 。 调 整 参 数 的 处 理应 该 在 调用 函数 之 前 ( 上 图 “ 验 
证 输入 值 的 合法 性 ”之 后 ) 由 调用 方 执行 。 被 调用 的 函数 方 应 当 
根据 契约 放心 地 使 用 参数 。 这 样 能 保证 代码 简洁 。 

不 过 ， 为 应 对 参数 不 合法 的 情况 ， 函 数 方 还 是 应 该 通过 断言 检查 
韶 约 的 履行 情况 ， 提 高 调试 的 效率 。 





函数 方 的 断言 不 用 在 用 户 的 输入 检查 中 

最 具 代 表 性 的 外 部 输入 值 当 属 用 户 在 屏幕 上 输入 的 值 。 不 过 ， 前 置 条 
件 只 是 函数 与 函数 调用 方 的 契约 ， 不 是 函数 与 用 户 输入 的 契约 。 没 有 
绪 行 契约 ， 就 表示 不 该 发 生 的 事情 发 生 了 ， 这 与 用 户 的 输入 错误 有 本 
质 上 的 区 别 。 这 两 个 概念 一 定 不 能 混淆 。 用 户 的 输入 检查 需要 在 调用 
函数 之 前 (上 图 的 “验证 输入 值 的 合法 性 ”) 由 函数 调用 方 完成 。 





预想 应 严格 ， 约 定 应 宽容 

如 果 要 保证 函数 能 接受 所 有 的 值 ， 并 且 在 任何 时 候 都 能 返回 正确 
结果 ， 就 需要 编写 大 量 的 代码 。 为 防止 此 类 事情 发 生 ， 我 们 要 对 
处 理 前 的 预想 ( 前 置 条 件 ) 有 较 高 的 要 求 ， 函 数 返回 结果 时 应 尽 
量 减少 约定 (后 置 条 件 )。 

尽量 少 写 代码 。 我 们 追求 的 是 “懒惰 的 代码 ”。 


局 5 河 汪 不 变 式 





在 面向 对 象 的 契约 式 设 计 中 ， 除 函 数 的 前 置 条 件 和 后 置 条 件 ， 还 
有 一 项 契约 是 “不 变 式 "。 

这 项 契约 保证 类 对 于 使 用 类 的 一 方 来 说 一 直 为 真 。 虽 然 这 一 点 无 法 
在 函数 内 部 处 理 的 过 程 中 得 到 保证 ， 但 在 函数 执行 结束 ， 控 制 返还 给 调 
用 方 的 时 候 ， 不 变 式 能 得 到 履行 。 
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类 方 要 保证 该 契约 能 被 履行 。 


:有 二 是 断言 


在 代码 中 ， 预 想 之 外 的 东西 用 断言 来 表现 。 

大 部 分 编程 语言 有 as sert 这 样 一 个 检查 表达 式 真 伪 的 功能 。 我 们 
要 把 应 满足 条 件 的 表达 式 传 给 assert 的 参数 。 

断言 为 真 ， 则 表示 所 有 代码 都 在 顺利 运行 。 断 言 为 假 ， 则 表示 从 代 
码 中 检测 出 了 预想 之 外 的 错误 。 当 断言 为 假 时 ， 软 件 会 停止 运行 并 返回 
信息 提示 用 户 发 生 了 不 该 发 生 的 事情 。 

断言 用 于 让 开发 过 程 中 的 代码 暴露 出 相互 矛盾 的 条 件 、 预 想 之 外 的 
状态 、 传 递 给 函数 的 非法 值 等 。 断 言 能 够 让 违反 契约 的 行为 以 及 修改 代 
人 码 时 混入 的 错误 迅速 暴露 出 来 ， 在 规模 巨大 日 复杂 度 较 高 的 代码 和 对 可 
靠 性 要 求 较 高 的 代码 中 特别 有 效 。 
使 用 断言 时 有 几 点 需要 我 们 注意 。 

传递 给 断言 的 表达 式 不 能 有 改变 变量 的 值 之 类 的 副作用 。 断 言 是 否 
被 执行 会 根据 编译 方法 而 发 生 改 变 。 一 旦 变量 的 值 发 生变 化 ， 运 行 差异 
就 会 给 我 们 造成 困扰 。 
断言 不 应 该 包含 在 发 布 版 的 软件 中 。 晰 言 是 用 来 进行 开发 和 维护 的 。 
断言 的 信息 并 不 是 给 终端 用 户 看 的 。 软 件 中 包含 断言 会 影响 软件 的 性 能 。 
所 以 在 发 布 版 的 软件 中 ， 一 定 要 记得 将 断言 从 编译 对 象 中 剔除 出 去 。 



























































E33 后 后 加 别 继续 执行 代码 不 如 让 软件 停止 运行 








在 代码 的 执行 过 程 中 ， 一 旦 发 生 了 不 该 发 生 的 事 ， 应 尽早 让 软件 停 
止 运 行 。 

当 发 生 不 该 发 生 的 事 时 ,代码 就 陷入 了 无 法 继续 运行 的 状态 。 强 制 
运行 只 会 使 倩 况 变 得 越 来 越 糟 。 损 坏 的 数据 一 旦 进入 重要 的 数据 库 中 ， 
将 会 酿 成 无 法 挽回 的 后 果 。 

考虑 到 这 些 风 险 ， 在 出 现 可 疑 情 况 时 ， 软 件 应 立刻 停止 运行 。 相 较 









































于 带 着 故障 继续 勉强 运行 ， 立 刻 停止 运行 的 做 法 危害 更 小 。 
所 以 在 发 生 问题 时 ， 应 尽快 完成 释放 资源 、 输 出 日 志 等 最 低 限 度 的 
处 理 ， 然 后 尽早 停止 软件 的 运行 。 
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防御 性 编程 


英 语 Defensive programming 





2 对 防 患 于 未 然 的 程序 设计 


我 们 在 编程 的 时 候 不 要 想当然 。 

防御 性 编程 与 开车 时 的 防御 性 驾驶 是 同一 种 思路 。 

在 采取 防御 性 驾驶 这 一 驾驶 方式 的 情况 下 ， 我 们 总 抱 有 一 种 不 知道 
其 他 驾驶 员 会 做 出 什么 事情 的 心态 。 也 就 是 说 ， 自 己 不 认为 驾驶 的 过 程 
是 百分之百 安全 的 ， 觉 得 中 途 可 能 会 发 生 什么 事 。 这 样 一 来 ， 当 其 他 驾 
驶 员 做 出 一 些 危 险 的 行为 时 ， 自 己 就 能 做 好 充分 的 准备 不 受伤 害 。 即 便 
过 失 在 其 他 驾驶 员 身 上 ， 自 己 的 命 也 要 由 自己 来 保护 。 防 御 性 驾驶 体现 
的 驶 是 这 样 一 种 心理 。 

与 此 类 似 ， 当 函数 接收 到 非法 数据 时 ， 即 便 问 题 出 在 其 他 函数 身 
上 上 ， 我 们 也 应 准备 好 “防御 性 ”的 代码 以 避免 函数 受到 损害 。 为 此 ， 编 
程 时 要 注意 以 下 几 点 内 容 。 





















































e 确认 外 部 代码 传 来 的 数据 输入 值 ( 检测 “预想 之 内 的 错误 ”) 
在 从 文件 、 用 户 接口 、 网 络 以 及 其 他 外 部 接口 获取 数据 时 ， 要 确 
认 数 据 是 否 在 合法 范围 内 。 比 如 检查 数值 是 否 在 有 效 范 围 内 、 字 
符 串 的 长 度 是 否 符合 规定 等 。 
尽量 在 较 早 的 阶段 检测 出 无 效 输入 。 检 测 出 无 效 输 入 后 要 迅速 对 
其 进行 适当 的 错误 处 理 。 
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e 确认 参数 的 值 ( 检测 “预想 之 外 的 错误 ”) 

确认 其 他 函数 传 来 的 参数 的 值 。 与 检测 外 部 代码 传 来 的 数据 不 
同 ， 这 里 如 果 检 测 出 无 效 输 入 ， 就 意味 着 代码 存在 bug。 

我 们 可 以 使 用 断言 确认 参数 ， 在 发 现 非法 值 时 立刻 停止 程序 。 


7 开发 与 运 维 中 的 “安全 驾驶 " 








就 像 防御 性 驾驶 能 使 驾驶 更 安全 一 样 ,“ 防 御 性 编程 ”可 以 让 编程 
安全 。 
安全 表现 在 如 下 两 个 方面 。 























e 开发 中 的 “安全 驾驶 ” 
提早 发 现 非法 数据 能 提升 调试 的 效率 ， 因 为 提早 检测 出 非法 数 
据 ， 并 以 明确 的 形式 进行 通知 ， 可 以 帮助 我 们 立刻 找到 出 现 问题 
的 地 方 。 这 样 一 来 ， 代 码 的 调查 与 修改 都 变 得 非常 容易 。 
反 过 来 ， 如 果 没 能 提早 检测 出 非法 数据 ， 那 么 故障 就 会 蔓延 到 其 
他 地 方 ， 这 时 我 们 就 需要 花费 更 多 的 时 间 来 寻找 根本 原因 。 


e 运 维 中 的 “安全 驾驶 ” 

尽早 处 理 非 法 数据 能 防止 运 维 中 出 现 的 问题 进一步 扩大 。 在 较 早 
的 阶段 处 理 掉 问 题 ， 能 防止 问题 的 蔓延 。 

错误 如 果 处 理 得 不 彻底 就 会 蔓延 到 其 他 处 理 中 ， 问 题 会 变 得 越 来 
越 大 。 特 别 是 当 错 误 的 数据 进入 软件 深 处 时 ， 软 件 的 运行 可 能 会 
发 生 错 误 ， 或 者 错误 的 数据 会 进入 数据 库 中 ， 这 将 造成 无 法 挽回 
的 后 果 。 

其 中 最 棘手 的 当 属 安全 问题 。 黑 窜 在 入 侵 系统 时 ， 喜 欢 利用 没有 
彻底 处 理 错误 的 地 方 。 可 见 ， 不 完备 的 错误 处 理 也 可 能 会 成 为 安 


全 漏洞 。 
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二 路 障 战术 


我 们 需要 采用 “路 障 战术 ”。 














建立 路 障 ， 将 损害 控制 在 一 定 的 区 域内 。 


船体 由 多 个 相互 隔离 的 区 域 组 成 ， 这 与 路 障 战术 是 同一 种 战略 思 





。 即 便 船 撞 上 冰山 ， 船 体 破损 ， 


会 有 沉没 的 危险 。 





只 要 隔离 破损 的 区 域 ， 整 个 船体 就 不 


另外 ， 建 筑 物 中 的 防火 墙 与 路 障 战术 也 有 有 异曲同工 之 妙 。 防 火 墙 的 





作用 在 于 防止 火势 蔓延 








为 了 在 代码 中 建立 路 了 我 们 需要 将 特定 的 接口 用 作 安 全 地 带 与 非 


安全 地 带 的 分 界线 。 检 验 通 过 这 条 








立即 采取 适当 的 措施 。 





分 界线 的 数据 ， 一旦 发 现 非法 数据 ， 











这 就 好 比 手术 室 ， 所 有 东 














过 大 门 进入 手术 室 的 东西 都 是 安 








i 都 必须 经 过 消毒 才能 拿 进 去 。 因 此 ， 通 


人 的。 


以 门 (= 路障 ) 为 界 ， 分 界线 的 左 侧 是 “ 脏 房间 "， 右 侧 是 “干净 


的 房间 ”。 


GUI 





CUI 


: 





脏 房间 





干净 的 房间 


本 











在 代码 设计 中 ， 我 们 要 明确 








西 不 能 进入 手术 室 ”， 以 及 “ 门 
块 、 安 全 地 带 外 面 的 模块 和 在 中 
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“哪些 东西 可 以 进入 手术 室 ”“ 哪 些 东 
的 位 置 "， 也 就 是 对 安全 地 带 里 面 的 模 
间 负 责 消 毒 的 模块 进行 分 工 。 























5 和 断言 与 错误 处 理 的 区 别 





用 断言 应 对 预想 之 外 的 错误 ， 用 合适 的 错误 处 理 方法 应 对 预想 之 内 的 
错误 。 采 用 路 障 战术 之 后 ， 我 们 就 能 明确 区 分 这 两 种 应 对 错误 的 方法 了 。 

在 路 障 外 面 对 数 据 进行 预测 是 一 种 危险 的 行为 。 因 此 ， 路 障 外 面 的 
模块 适合 使 用 错误 处 理 的 方法 。 

而 传 到 路 障 内 的 数据 在 通过 路 障 之 前 就 已 经 “ 消 过 毒 ” 了 。 如 果 路 
障 内 的 某 个 模块 检测 到 了 非法 数据 ， 那 一 定 不 是 数据 出 现 了 错误 ， 而 是 
代码 出 现 了 错误 。 因 此 ， 路 障 内 的 模块 不 能 采用 应 对 数据 错误 的 错误 处 
理 方法 ， 而 要 采用 断言 让 代码 自 映 来 检查 代码 执行 过 程 中 是 否 有 问题 。 


错误 处 理 的 变种 


对 于 预想 之 内 的 错误 ， 不 同 的 情况 有 不 同 的 处 理 方式 。 具 体 来 说 有 
以 下 几 种 处 理 方式 。 


















































e 返回 无 害 的 值 

在 确认 某 值 无 害 的 情况 下 ， 返 回 该 值 。 

比如 在 数值 计算 的 情况 下 返回 0， 在 字符 串 计算 的 情况 下 返回 空 
字符 串 ， 在 指针 计算 的 情况 下 返回 NULL。 


使 用 下 一 个 数据 

在 处 理 一 连 串 数据 的 情况 下 ， 返 回 下 一 个 有 效 数 据 。 

以 从 数据 库 读 取 记 录 为 例 ， 如 果 记 录 无 效 ， 则 一 直 读 取 ， 直 到 发 
现 有 效 记 录 。 


返回 和 前 面 一 样 的 值 

如 果 不 会 对 结果 造成 重大 影响 ， 则 返回 和 前 面 一 样 的 值 。 

以 1 秒 内 读 取 100 次 温度 计 的 代码 为 例 ， 如 果 其 中 有 一 次 读 取 失 
败 ， 在 这 种 情况 下 ， 即 使 返回 失败 前 最 后 一 次 读 取 的 值 ， 也 不 会 
有 什么 问题 。 
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e 使 用 近似 值 
在 满足 一 定 的 严密 性 的 前 提 下 ， 返 回 近似 值 。 
比如 在 能 显示 0%C ~100sC 的 温度 显示 画面 中 ， 温 度 低 于 0%C 时 显 
示 0%C， 高 于 100%C 时 显示 100%C。 


在 日 志 中 记录 警告 信息 

在 上 日志 文件 中 记录 警告 信息 后 继续 执行 处 理 。 

当 发 生 微小 的 错误 时 ， 忽 略 错误 继续 执行 处 理 有 时 是 一 个 很 好 的 
选择 。 不 过 ， 发 生 过 的 错误 一 定 要 记录 下 来 。 


返回 错误 

为 了 调用 上 游 函 数 来 处 理 错 误 ， 我 们 要 将 检测 出 来 的 错误 记录 在 
报告 中 。 

在 这 种 情况 下 ， 决 定 让 代码 的 哪个 部 分 负责 处 理 错误 ， 哪 个 部 分 
负责 报告 错误 就 变 得 至 关 重 要 。 

我 们 可 以 使 用 模块 的 状态 变量 、 函 数 的 返回 值 ， 或 者 通过 抛 出 异 
常 来 报告 错误 。 


调用 错误 处 理 函 数 

错误 处 理 要 交 给 共同 的 错误 处 理 函 数 来 完成 。 

将 错误 处 理 的 责任 一 元 化 能 降低 调试 的 难度 。 不 过 ， 这 个 一 元 化 
的 功能 会 使 代码 整体 产生 较 高 的 耦合 度 。 因 此 ， 如 果 想 把 一 部 分 
代码 用 到 其 他 系统 中 ， 就 需要 连同 错误 处 理 算法 一 起 “搬家 ”。 


显示 错误 信息 

在 发 生 错误 的 地 方 显示 错误 信息 。 

将 错误 处 理 的 开销 抑制 到 最 小 。 不 过 ， 由 于 信息 会 分 散在 软件 各 
处 ， 所 以 创建 具有 统一 性 的 用 户 接口 、 区 分 用 户 接口 与 其 他 部 
分 、 将 软件 转换 为 其 他 语言 等 工作 变 得 难以 实施 。 


e@ 终止 处 理 

检测 到 错误 后 终止 处 理 。 

这 个 方法 对 重视 安全 性 的 软件 来 说 非常 有 效 。 在 关键 任务 系统 
中 ， 比 起 带 着 错误 继续 处 理 ， 很 多 时 候 重新 启动 程序 会 比较 好 。 





e 各 部 分 选择 最 合适 的 方式 处 理 错误 

选择 何 种 方式 处 理 错误 ， 由 负责 设计 与 实现 错误 发 生 部 分 的 程序 
员 来 决定 。 

这 给 了 程序 员 很 大 自由 ， 但 从 软件 整体 来 看 ， 错 误 处 理 将 失去 统 
一 性 。 


局 二 错误 处 理 中 的 “正当 性 ”和 “坚固 性 ” 





错误 处 理 中 有 “正当 性 ”和 “坚固 性 ”两 种 思路 。 

正当 性 指 一 定 不 返回 不 正确 的 结果 。 与 其 返回 不 正确 的 结果 ， 不 如 
什么 都 不 返回 。 

而 坚固 性 指 为 了 让 软件 继续 运行 而 不 择 手 段 。 即 使 会 产生 不 正确 的 
结果 ， 也 要 让 软件 继续 运行 下 去 。 

以 哪 种 思路 为 先 ， 就 要 看 软件 的 目的 是 什么 了 。 

重视 安全 性 的 软件 要 以 正当 性 为 先 。 与 其 返回 错误 结果 ， 不 如 直接 
停止 软件 。 以 医疗 相关 的 管理 软件 为 例 ， 相 较 于 返回 错误 结果 继续 处 
理 ， 通 知 错误 并 停止 软件 更 能 防止 重大 事故 的 发 生 。 

而 对 于 提供 给 用 户 的 软件 ,坚固 性 就 要 优先 于 正当 性 了 。 以 文字 处 
理 软件 为 例 ， 比 起 软件 突然 关闭 导致 大 量 宝贵 的 输入 数据 丢失 ， 带 着 错 
误 继 续 运 行 所 造成 的 损失 更 小 。 




























































































有 局; 汉 册 国 将 输入 数据 转换 为 正确 的 格式 


通常 ， 当 外 部 传 来 数据 时 ， 软 件 需要 对 其 进行 “消毒 ”。 此 时 ， 我 
们 要 让 数据 在 输入 的 瞬间 就 转换 成 正确 的 格式 。 
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一 般 情 况 下 ， 输 入 数据 会 以 字符 串 或 数值 的 形式 传递 。 这 些 值 有 
时 被 映射 为 Yes、No 等 布尔 型 ， 有 时 被 映射 为 Red、Green、Blue 等 
列举 型 。 

格式 不 定 的 数据 逗留 在 代码 中 会 使 情况 变 得 复杂 。 这 时 ， 有 人 可 能 
就 把 Yes 当 作 颜色 输入 进去 ， 使 软件 发 生 冲 突 。 记 住 ， 输 入 的 数据 一 定 
要 立刻 转换 成 正确 的 格式 才 行 。 这 是 基本 中 的 基本 。 





























5 二" 不 忽视 错误 代码 


不 忽视 错误 代码 是 防御 性 编程 的 铁 则 。 
即使 函数 返回 错误 代码 ， 接 收 方 也 有 可 能 会 忽视 掉 它 。 但 是 ,我 们 
一 定 要 养 成 评价 函数 返回 值 的 习惯 。 即 便 某 个 函数 在 理论 上 不 会 发 生 错 
误 ， 保 险 起 见 我 们 也 要 对 其 进行 检查 。 因 为 防御 性 编程 的 目的 就 是 防止 
预料 之 外 的 情况 出 现 。 

自己 编写 的 函数 不 能 忽视 错误 ， 系 统 函 数 同样 不 能 。 每 次 进行 系统 
调用 都 要 检查 错误 代码 。 

发 现 错误 之 后 ， 要 在 日 志 中 输出 错误 编号 以 及 错误 的 详细 内 容 。 


习 : 冯 司 二 明 “到 语言 中 ”编程 


“在 语言 中 ”编程 的 程序 员 会 把 自己 的 想法 限定 在 该 语言 直接 支持 
的 结构 中 。 因 此 ， 如 果 使 用 的 语言 比较 初级 ， 程 序 员 的 想法 就 会 受到 语 
言 的 限制 ， 变 得 初级 。 
而 “到 语言 中 ”编程 的 程序 员 会 先 思 考 自 己 想 表达 什么 样 的 思维 录 
， 然 后 将 思维 逻辑 套用 到 本 次 使 用 的 语言 中 ,决定 具体 的 表达 方法 。 
所 以 ， 我 们 不 应 “在 语言 中 ”编程 ， 而 应 “到 语言 中 ”编程 。 
不 可 和 否认， 很 多 时 候 语言 中 并 不 包含 我 们 想 使 用 的 表达 方法 。 但 
是 ,一 个 好 的 想法 不 应 该 被 语言 的 机 制 束缚 ， 而 应 该 突破 语言 障 但 得 到 
实现 。 

我 们 可 以 尝试 用 非 标 准 库 进行 补充 ， 或 者 借助 预 编 译 来 实现 标准 
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化 。 如 果 再 不 行 ， 还 可 以 考虑 使 用 编码 规则 来 对 编程 行为 进行 约束 。 

假设 我 们 想 在 代码 中 表达 “契约 式 设计 ”或 “防御 性 编程 ”的 思 
路 ， 但 语言 并 不 具备 断言 功能 。 在 遇 到 这 种 情况 时 ， 我 们 不 能 把 眼光 局 
限 在 语言 之 中 ， 放 弃 自 己 的 想法 ， 而 应 该 寻找 合适 的 开源 库 , 或 者 自己 
编写 宏 ， 想 方 设法 将 思路 实现 到 语言 中 去 。 
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内 部 测试 


= 


莫 语 Dogfooding 


Eating your own dog food 





试 尝 软 件 的 “味道 ” 


我 们 要 试 着 用 一 下 自己 开发 的 软件 。 

还 未 开发 完成 或 者 刚刚 发 布 的 软件 ， 其 质量 还 不 够 好 ， 软 件 本 身 并 
不 完美 。 这 时 的 软件 可 能 “味道 ”不 是 很 好 。 

即便 如 此 ， 它 也 是 我 们 自己 开发 的 软件 ， 是 拿 给 别人 用 的 东西 。 所 
以 我 们 自己 要 先 “品尝 ”一 下 软件 的 “味道 ”。 























LEA 汪 从 用 户 的 角度 出 发 








对 于 自己 开发 的 东西 ， 开 发 团队 总 会 下 意识 地 回避 故障 。 

而 以 用 户 的 身份 使 用 软件 ， 能 帮助 我 们 站 在 用 户 的 角度 思考 问题 。 

这 样 一 来 ， 我 们 就 能 发 现 测试 时 没有 发 现 的 缺陷 。 在 用 户 使 用 软件 
之 前 发 现 软件 的 故障 并 对 其 进行 修正 ， 能 提高 软件 的 稳定 性 。 

另外 ， 以 用 户 的 身份 使 用 软件 ， 也 能 发 现 一 些 没有 用 的 功能 以 及 其 他 
可 能 会 用 到 的 功能 ， 还 能 发 现 哪 些 功 能 用 起 来 不 是 很 顺手 。 这 样 一 来 ， 
我 们 就 能 发 现 一 些 站 在 程序 员 的 角度 无 法 发 现 的 需要 改善 的 地 方 ， 解 决 
功能 过 剩 与 功能 不 足 的 问题 ， 改 善 用 户 体验 ， 提 升 软件 的 魅力 。 


















































以 用 户 的 身份 使 用 软件 





在 发 布 软件 之 前 ， 我 们 要 作为 用 户 使 用 一 下 软件 。 不 是 去 模仿 用 
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户 ， 而 是 真正 地 作为 用 户 去 使 用 软件 。 
软件 在 发 布 之 前 通常 质量 较 差 ， 可 能 会 影响 日 常 工作 。 但 是 和 被 用 
户 抛弃 的 风险 相 比 ， 这 算 不 了 什么 。 在 发 布 之 前 以 用 户 的 身份 使 用 软 
件 ， 能 确保 软件 的 稳定 性 ， 避 免 引起 用 户 的 不 满 ， 还 能 改善 功能 ， 吸 引 
更 多 的 用 户 。 我 们 没有 不 做 之 理 。 
当然 ， 发 布 之 后 也 要 坚持 使 用 自己 的 软件 。 既 然 打 着 “方便 好 用 ” 
的 旗号 把 软件 交 给 用 户 ， 就 应 该 亲自 使 用 软件 证 明 给 他 们 看 。 
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橡皮 了 鸭 调 试 法 

英 语 Rubber ducking 

别 名 小 黄岗 调试 法 
黄 鸭 除 虫 法 

















本 到 对 谷 助 “说 明 ” 完 成 调试 


橡皮 觅 调试 法 是 一 种 调试 方法 。 

在 编程 的 过 程 中 ,我们 要 把 出 现 的 问题 或 者 有 问题 的 代码 说 给 
“ 某 个 人 ” 听 。 这 样 一 来 ,我们 就 能 找到 问题 出 现 的 原因 ， 并 对 问题 巴 
以 解决 。 

这 里 的 “ 某 个 人 ”可 以 是 物品 ， 比 如 放 在 浴缸 里 的 橡皮 觅 等 ， 只 要 
能 一 边 点 头 一 边 听 我 们 说 话 即 可 ， 其 自身 不 需要 讲话 。 

这 一 方法 能 产生 立 笔 见 影 的 效果 。 有 时 候 ， 我 们 刚 开始 说 明 就 能 注 
意 到 问题 所 在 。 

这 个 方法 简单 是 廉价 ， 但 效果 出 奇 地 好 。 

















zi 促使 自己 解决 问题 


橡皮 鸭 调 试 法 因为 操作 起 来 太 过 简单 ， 所 以 很 多 人 觉得 没有 多 大 意 
义 。 但 事实 并 非 如 此 。 

在 向 他 人 说 明 问 题 之 前 ， 我 们 首先 要 通读 代码 ， 明 确 其 中 隐藏 的 假 
定 条 件 。 我 们 在 把 这 些 假定 条 件 说 出 来 的 时 候 ， 会 对 问题 产生 新 的 见 
解 ， 这 些 新 的 见解 会 成 为 解决 问题 的 突破 口 。 

男 外 ， 在 说 明 的 过 程 中 ， 一旦 说 到 有 问题 的 代码 ， 我 们 就 会 发 现 该 部 分 
“无 法 说 明 ”， 或者“ 说明 的 内 容 与 代码 不 符 ”， 从 而 发 现存 在 缺陷 的 地 方 。 
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只 要 像 上 面 那样 按部就班 地 对 问题 进行 说 明 ， 问 题 出 现 的 原因 就 能 
浮现 出 来 。 


过 恒 向 没有 生命 的 物品 说 明 问 题 





在 解决 问题 时 ， 如 果 遇 到 瓶 绒 ， 可 以 找 一 个 倾诉 对 象 说 明 一 下 
问题 。 

这 个 对 象 可 以 是 橡皮 觅 等 没有 生命 的 物品 。 重 要 的 是 “说 明 ” 这 一 
行为 。 

比如 某 大 学 信息 技术 系 的 服务 台 劳 边 总 会 备 一 个 泰 迪 能 玩偶。 该 
校规 定 ， 学 生 在 遇 到 奇怪 的 故障 时 ， 必 须 先 向 这 个 玩偶 说 明 一 遍 问 题 再 
咨询 工作 人 员 。 该 做 法 取得 了 很 好 的 效果 。 

但 话说 回来 ， 最 好 的 说 明 对 象 仍然 是 程序 员 同 事 。 因 为 我 们 在 向 他 
们 说 明 时 最 具 真 实感 和 临场 感 。 我 们 自己 无 法 解决 问题 的 时 候 ， 对 方 还 
会 给 出 建议 。 

不 过 ,同事 的 时 间 也 是 宝贵 的 。 从 团队 优化 的 角度 来 看 ， 在 使 用 橡 
皮 鸭 调试 法 时 ， 以 物品 为 倾诉 对 象 的 效果 更 佳 。 如 果 无 论 如 何 都 要 与 同 
事 交 流 ， 应 先 说 明 主 由， 取得 对 方 的 同意 。 
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语 境 


= 


莫 语 Context 





过 此 A 在 语 境 中 对 话 ， 结 合 语 境 思 





语 境 又 称 为 上 下 文 ， 指 周围 的 情况 与 背景 。 
编程 时 ， 我 们 要 从 两 个 侧面 充分 利用 语 境 这 个 概念 。 





e 用 于 代码 的 读 写 

代码 的 读 写 是 写 代 码 的 人 与 读 代 码 的 人 之 间 的 交流 。 写 代码 时 
要 注意 给 读 代码 的 人 创造 语 境 。 为 此 ， 我 们 要 自 上 而 下 地 编写 
代码 。 

具体 来 说 ， 就 是 让 模块 名 等 大 块 代码 的 名 称 足 以 说 明 这 块 代 码 是 
做 什么 的 。 模 块 中 的 函数 名 也 要 以 模块 名 为 语 境 ， 并 体现 出 函数 
做 了 什么 样 的 处 理 。 

这 样 一 来 ， 对 读 代 码 的 人 而 言 ， 模 块 的 名 称 和 函数 的 名 称 就 相当 
于 图 书 的 章 标题 和 节 标 题 ， 用 于 提醒 人 们 当前 阅读 的 是 哪里 的 代 
码 。 这 对 读 代码 的 人 非常 有 帮助 。 


用 作 思 考 的 工具 

编程 是 一 种 解决 问题 的 工作 。 

只 关注 单独 的 要 素 不 足以 解决 问题 。 事 物 不 是 单独 存在 的 ， 它 们 
与 周围 的 情况 息息相关 ， 有 自身 存在 的 原因 。 所 有 要 素 相 互 关 
联 ， 相 互 过 扯 。 把 这 些 东 西 视 为 语 境 纳入 思考 的 范围 ， 能 帮助 我 
们 解决 问题 。 
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出 防止 对 话 与 思考 失去 方向 


给 说 明 附 上 语 境 ， 能 将 零散 的 信息 联系 在 一 起 。 于 是 ， 代 码 的 意义 
变 得 更 加 连贯 ， 代 码 的 可 读 性 变 得 更 高 ， 读 代码 的 人 也 不 容易 让 自己 的 
思考 失去 方向 。 

代码 必须 能 让 读 代码 的 人 轻松 理解 代码 正在 做 什么 。 没 有 语 境 ， 对 
方 就 失去 了 理解 的 基础 ， 信 息 传递 的 效率 必然 不 高 。 
程 高 手 都 会 使 用 语 境 。 他 们 会 从 直觉 上 联系 语 境 ， 并 结合 自身 的 
经 验 ， 从 现 有 的 解决 方案 中 选择 一 个 合适 的 方案 来 实施 。 当 然 ， 这 里 的 
直觉 是 有 根据 的 直觉 。 毕 竞 这 些 编程 高 手 能 读 懂 代 码 的 “氛围 "， 所 以 
他 们 不 用 按照 条 条 框框 来 进行 操作 。 
而 初学 者 常常 忽视 语 境 ， 按 照 条 条 框框 工作 。 他 们 只 会 按照 指示 做 
事 ， 因 此 最 终 展示 出 来 的 成 果 会 与 编程 高 手 存在 差点。 速度 和 质量 都 相 
去 其 远 。 而 且 初 学 者 一 般 无 法 应 对 未 知情 况 ， 所 以 在 某 些 情况 下 即使 花 
再 多 的 时 间 也 不 会 得 到 很 好 的 结果 ， 此 时 初学 者 与 编程 高 手 的 差距 就 无 
法 计量 了 。 
程 高 手 之 所 以 能 熟练 运用 各 种 模式 ， 并 不 是 因为 他 们 知道 的 模式 
多 ， 而 是 因为 他 们 知道 模式 应 该 在 何 种 情况 下 使 用 、 以 何 种 目的 使 用 
编程 高 手 看 的 就 是 语 境 。 
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志恒 展 示 语 境 


在 写 代 码 时 ， 要 先 将 语 境 展 示 出 来 。 这 样 一 来 ， 读 代码 的 人 就 能 对 
具体 情况 做 出 判断 ， 第 一 时 间 掌 握 这 些 代 码 的 用 途 。 

在 读 代码 时 ， 应 先 获 取 语 境 ， 然 后 在 此 基础 之 上 理解 代码 。 

在 设计 代码 时 ， 应 效仿 高 手 的 思考 方式 。 要 成 为 高 手 ， 最 有 效 的 方 
法 就 是 模仿 高 手 的 行为 。 具 体 来 说 ， 就 是 在 解决 问题 时 ， 以 语 境 为 前 提 
进行 思考 。 我 们 没有 高 手 丰富 的 经 验 ， 但 是 可 以 模仿 他 们 的 思考 方式 。 
我 们 要 训练 自己 ,让 自己 认识 到 语 境 的 存在 ， 挖 气 问 题 的 语 境 ， 根 据 情 
况 和 目的 进行 判断 。 
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另外 ， 要 让 所 有 工作 都 远离 那些 独立 于 语 境 的 绝对 规则 。 为 了 摆脱 
初学 者 的 身份 ， 成 为 高 手 ， 我 们 要 将 重心 放 在 直觉 上 。 久 而 久之 ,我 们 
就 会 像 系 统 思 维 所 提倡 的 那样 ， 自 己 成 为 系统 的 一 部 分 ， 主动 地 去 解决 
问题 。 

此 外 ， 我 们 还 要 以 “着 眼 大 局 ， 着 手 小 局 ”为 工作 战略 。 要 先 结合 
语 境 看 整体 ， 完 成 构想 ,然后 一 点 一 点 进行 实践 。 这 样 ， 我 们 就 能 做 成 
一 件 大 事 。 


语 境 与 工作 委托 


在 委托 别人 写 代 码 的 时 候 ， 语 境 的 相关 观点 同样 有 效 。 

我 们 在 让 编程 高 手写 代码 时 ， 不 需要 设置 什么 条 条 框框 的 规则 ， 只 
要 将 足够 搭建 语 境 的 信息 告诉 对 方 即 可 ， 之 后 便 可 任 其 自由 发 挥 。 这 样 
编程 高 手 就 能 做 出 最 好 的 作品 。 

相反 ， 用 规则 束缚 编程 高 手 ， 并 不 是 什么 明智 之 举 。 让 一 大 群 马 
聚 在 一 起 奔跑 ， 马 一 定 跑 不 开 。 况 且 人 还 有 情绪 方面 的 问题 。 多 余 的 规 
则 会 降低 人 的 积极 性 ， 益 不 好 还 会 把 人 逼 出 团队 ， 使 团队 的 战斗 力 大 打 
折扣 。 

我 们 要 告诉 高 手 最 终 要 达到 的 目标 ， 这 一 点 并 不 限于 编程 。 

比如 对 于 清扫 能 手 ， 你 想 让 他 去 打扫 浴室 ， 这 时 只 要 告诉 他 把 浴室 
打扫 干净 即 可 。 清 扫 能 手 看 到 浴室 的 具体 情况 ， 就 会 选择 合适 的 工具 ， 
然后 结合 性 价 比 、 时 间 等 因素 ， 找 出 最 佳 的 解决 方案 并 付 诸 行动 。 如 果 
浴室 已 经 脏 到 无 法 打扫 干净 了 ， 清 扫 能 手 可 能 会 跟 你 谈 重 新 装修 的 事 
情 。 总 而 言 之 ,他 们 会 采用 各 种 手段 ,倾注 全 力 来 达到 目的 。 

换 成 初学 者 的 话 ， 这 种 方式 就 行 不 通 了 。 如 果 只 提供 “把 浴室 打扫 
干净 ”这 样 一 个 抽象 度 较 高 的 信息 ， 他 们 就 会 无 从 下 手 。 因 此 ， 你 需 
下 达 一 些 具体 的 命令 ， 比 如 先 用 刷子 刷 一 遍 浴 室 ， 等 等 。 

然而 初学 者 并 不 理解 真正 的 目的 ， 他 们 只 会 去 刷 一 遍 浴 室 。 而 且 就 
算 刷 的 时 修 因 力 道 不 足 或 次 数 较 少 而 没 刷 干净 ， 也 会 向 你 报告 :“ 我 ( 按 你 
说 的 ) 刷 完 了 。” 你 过 去 一 看 ,浴室 确实 刷 了 一 壳 ， 但 它 并 没有 变 干 净 。 
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接 下 来 你 将 陷入 给 出 具体 方案 的 泥潭 。“ 用 这 么 大 的 力气 刷 ”“ 刷 三 
遍 以 上 ”“ 用 清洁 剂 *“ 清 洁 剂 用 这 么 多 ”“ 再 用 上 抹布 ”……… 每 做 完 一 
步 你 都 要 去 确认 一 下 ， 然 后 发 出 下 一 个 指示 。 

在 最 坏 的 情况 下 ， 你 还 可 能 会 落 一 个 “指示 有 问题 ”“ 尽 挑 毛病 ” 
的 埋 忽 。 再 加 上 初学 者 技术 较 差 ， 工 作 失 误 较 多 ， 能 做 的 事情 有 限 ,使 
得 指挥 也 变 成 了 一 项 苦 差 事 。 

这 样 想来 ， 高 手 非常 难得 。 我 们 要 努力 让 高 手 把 专 业 技 能 留 在 现 
场 。 要 让 他 们 在 工作 的 时 候 有 一 个 好 心情 ， 不 会 产生 离职 的 想法 。 

另外 ， 要 想 培 养 高 手 ， 让 高 手 维持 高 手 的 水 平 ， 必 须 把 高 手 放 在 一 
线 。 我 们 常 看 到 高 手 被 摆 在 管理 职位 上 ， 这 其 实 是 一 种 浪费 。 


语 境 的 传导 能 力 


语 境 对 交流 的 贡献 非常 大 。 

这 里 做 一 个 简单 的 实验 。 下 面 有 两 组 文字 。 上 面 一 组 不 分 类 别 ， 下 
面 一 组 是 食物 。 每 一 个 词 都 由 四 个 字 组 成 ， 但 是 文字 顺序 被 打 乱 了 。 请 
大 家 看 着 这 些 文字 联想 原来 的 词 。 






























































e@ 无 分 类 
秋 节 佳 中 
票 高 车 铁 
空 式 调 立 
里 万 城 长 
月 风 雪 花 
半 更 夜 三 
对 向 象 面 
机 气 喷 飞 
叔 门 提 九 
命 耳 面 提 
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e 食物 
腰 爆 炒 花 
子 鸡 辣 丁 
片 夫 肺 妻 
醋 里 糖 状 
蒸 清 鱼 鲁 


料 是 油 大 


上 








试 过 以 后 不 难 发 现 ， 第 二 组 词语 联想 起 来 比 第 一 组 简单 。 大 脑 仅 仅 
接收 了 一 个 “现在 即将 接收 这 类 信息 ”的 提示 ， 处 理 能 力 就 急剧 提高 。 
这 就 是 语 境 的 传导 能 力 。 

比如 ， 在 读书 的 时 候 ， 如 果 采 用 自 下 而 上 的 阅读 方式 ， 也 就 是 从 单 
词 开 始 理解 ， 然 后 是 句子 ， 最 后 是 文章 ， 就 会 给 大 脑 带 来 极 大 的 负担 。 

不 过 ， 书 是 有 标题 的 。 只 要 认真 阅读 标题 ， 我 们 就 能 顺畅 地 理解 后 
面 的 段落 和 文章 ， 因 为 段落 所 写 的 内 容 就 是 标题 所 表达 的 内 容 。 这 种 确 
认 标 题 与 正文 之 间 关 系 的 阅读 方法 更 加 合理 。 这 种 阅读 方法 称 为 “ 自 上 
而 下 型 阅读 ”。 

不 管 是 章 标题 还 是 节 标 题 ， 这 类 引导 人 们 理解 后 续 内 容 的 元 素 称 为 
“阅读 前 导 ”。 在 前 面 的 实验 中 ,“ 食 物 ” 就 是 阅读 前 导 。 

阅读 代码 和 阅读 图 书 是 一 样 的 。 代 码 中 的 标题 就 是 装载 着 某 一 类 内 
容 的 模块 的 名 称 。 对 于 代码 中 的 标题 ， 我 们 要 更 用 心地 去 读 。 反 过 来 ， 
在 写 代 码 的 时 候 ， 为 了 能 让 读 代码 的 人 构建 语 境 ， 一 定 要 认真 安排 阅读 
前 导 。 

即使 从 一 般 语 言 的 角度 来 说 ， 语 境 也 非常 重要 ， 因 为 单词 本 身 并 不 
具有 意义 ， 它 们 的 意义 只 体现 在 语 境 之 中 。 

比如 在 自家 厕所 里 ， 孩 子 焦急 地 大 喊 :“ 妈 !” 这 其 实 是 “ 帮 有 我 拿 红 ” 
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的 意思 。 又 比如 一 对 恋人 在 卿 卿 我 我 时 ， 其 中 一 方 羞 红 了 脸 说 :“ 笨 重 !” 
这 名 - EN 

语言 的 内 容 只 有 与 语 境 相 结合 才能 获得 意义 ， 才 有 价值 ， 才 能 传达 
出 正确 的 意思 。 











;3EEE 团 队 要 有 高 语 境 意识 





“高 语 境 ” 指 团队 在 背景 、 价 值 观 等 很 多 方面 有 共同 认识 的 状态 。 
在 高 语 境 文化 中 ， 人 们 沟通 起 来 很 有 默契 ， 许 多 事情 能 做 到 心照 不 
宣 。 一 般 来 说 ， 日 本 属于 高 语 境 文化 ， 欧 美 属于 低语 境 文化 。 
项 目 团队 进入 高 语 境 的 状态 后 ， 沟 通 会 变 得 顺畅 ， 沟 通 成 本 将 大 大 
减少 ， 沟 通 质量 能 得 到 提升 ， 这 对 产品 将 产生 好 的 影响 。 
不 过 ， 这 个 语 境 并 不 对 新 加 入 的 成 员 共 享 ， 所 以 对 于 新 加 入 的 成 
我 们 应 效仿 低语 境 文化 ， 系 统 地 对 事情 加 以 说 明 。 


























A 


ES; 冯 甩 代码 通用 化 应 注意 语 境 





将 代码 共同 的 部 分 函数 化 是 一 件 好 事 ， 但 有 两 点 需要 我 们 留意 。 


e 通用 化 的 部 分 有 时 需要 分 别 进行 修改 
就 算是 仅 由 几 行 代码 组 成 的 执行 相同 处 理 的 共同 部 分 ， 如 果 各 自 的 
内 部 代码 不 同 ， 这 种 共同 就 是 偶然 的 。 二 者 并 不 存在 依赖 关系 。 
即使 将 这 类 代码 通用 化 ， 以 后 需求 发 生 改 变 的 话 ， 还 是 要 还 原 通 
用 化 的 部 分 ， 然 后 各 自 按照 需要 进行 修改 。 
因此 ， 即 使 代码 内 有 多 个 地 方 需要 进行 同样 的 处 理 ， 只 要 这 些 处 
理 各 自发 挥 的 作用 不 同 ， 通 用 化 就 不 会 带 来 多 少 优势 。 


e 修改 通用 化 部 分 时 的 影响 程度 上 升 
代码 通用 化 之 后 ， 通 用 化 的 代码 与 使 用 该 代码 的 各 个 部 分 将 产生 
依赖 关系 。 也 就 是 说 ， 通 用 化 的 代码 即便 只 修改 一 行 也 会 影响 到 
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所 有 使 用 该 代码 的 部 分 。 

代码 相互 独立 时 ， 相 应 部 分 的 维护 成 本 小 到 可 以 忽略 。 而 通用 化 
之 后 ， 每 次 修改 都 要 花 大 量 时 间 进 行 测试 。 

代码 通用 化 能 减少 构成 软件 的 代码 的 行 数 ， 但 会 增强 代码 间 的 依 
赖 程度 。 











因此 ， 在 对 代码 进行 通用 化 时 ， 应 注意 其 语 境 。 即 便 产生 依赖 关 
系 ， 只 要 通用 化 的 代码 和 使 用 该 代码 的 部 分 处 于 同一 个 狭小 的 语 境 中 ， 
就 不 会 出 现 问 题 。 此 时 通用 化 的 优势 大 于 和 劣势。 不过， 如 果 在 较 大 的 语 
境 中 出 现 依赖 关系 ， 软 件 的 诸多 部 分 就 会 受到 牵连 ， 此 时 通用 化 的 劣势 
就 超过 了 优势 。 

因此 ， 在 软件 的 整体 结构 尚 不 清晰 的 阶段 ， 最 好 不 要 轻易 推进 代码 
的 通用 化 。 应 先 仔 细 观 察 各 部 分 之 间 的 关系 ， 确 认 语 境 ， 总 结 出 可 以 通 
用 化 的 部 分 。 


E353E 卫 刁 漠 程序 员 的 语 境 切换 


操作 系统 需要 让 多 个 进程 共享 同一 个 CPU。 因 此 ， 进 程 会 相互 
穿插 ， 此 时 就 需要 保存 或 还 原 CPU 和 内 存 的 状态 ， 也 就 是 保存 或 还 
原 语 境 。 我 们 把 这 项 操作 称 为 “ 语 境 切换 ”。 切 换 语 境 的 效率 是 评价 操 
作 系 统 的 一 个 重要 指标 ， 但 再 好 的 操作 系统 也 无 法 避免 语 境 切 换 带 来 的 
负担 。 

编程 中 也 会 出 现 同样 的 现象 。 

程序 员 的 脑 中 装 的 是 与 当前 问题 相关 的 工作 集 。 在 编程 的 过 程 中 一 
且 有 别 的 事情 插 进来 ， 我 们 就 必须 暂时 弃置 当前 的 工作 集 ， 转 而 加 载 需 
要 的 工作 集 。 也 就 是 在 脑 中 进行 语 境 切换 。 

在 编程 中 ， 其 他 事情 的 搬 和 人 造成 的 语 境 切 换 是 一 种 性 质 非 常 恶劣 、 
需要 我 们 避免 的 现象 。 之 所 以 这 么 说 ， 是 因为 程序 员 的 理想 是 让 自己 在 
编程 的 过 程 中 处 于 “ 流 态 ”。 

所 谓 流 态 ， 是 指 让 自己 沉浸 在 一 件 事 中 ， 处 于 一 种 冥想 的 状态 。 进 
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入 这 一 状态 后 ， 人 将 充满 幸福 感 ， 同 时 失去 对 时 间 的 感觉 。 觉 得 没 干 多 
长 时 间 ， 结 果 一 看 表 ， 都 过 去 3 个 小 时 了 ， 这 其 实 就 是 一 种 流 态 的 效 
果 。 进 入 这 一 状态 后 ， 编 程 的 效率 将 大 幅 提升 。 

对 于 编程 这 种 高 强度 的 脑力 劳动 ,“ 进 入 状态 ”是 非常 重要 的 ， 流 态 
不 可 或 缺 。 其 至 可 以 说 ， 我 们 只 有 进入 了 流 态 ， 才 能 让 工作 顺利 进行 。 

很 可 惜 ， 我 们 无 法 像 揭 下 开关 那样 自如 地 转换 自己 的 状态 。 要 想 进 
入 流 态 或 维持 流 态 ， 我 们 必须 要 实现 连续 工作 。 一 般 情 况 下 ， 我 们 需要 
花 15 分 钟 以 上 的 时 间 来 集中 精神 。 

而 妨碍 我 们 连续 进行 工作 的 ， 正 是 职场 中 的 各 种 “插入 事件 ”， 比 
如 有 人 过 来 跟 自己 说 话 、 有 会 要 开 、 旁 边 有 人 讨论 问题 、 电 话 响 了 、 窗 
口 跳出 未 读 邮 件 通 知 ， 等 等 。 

在 进入 流 态 之 前 的 这 段 时 间 里 ， 人 对 于 插入 事件 非常 敏感 。 因 此 ， 
我 们 几乎 不 可 能 在 嗜 杂 的 职场 环境 下 进入 流 态 。 

而 且 ， 就 算 有 机 会 进入 流 态 ， 一 个 插 人 事件 就 能 轻松 把 我 们 打 回 原 
形 。 一 旦 被 打 回 原形 ， 再 想 进 入 流 态 又 需要 至 少 15 分 钟 的 时 间 。 在 这 
期 间 ， 我 们 就 相当 于 什么 工作 都 没 做 。 

假设 接 一 通电 话 平均 需要 5 分 钟 ， 进 入 流 态 需要 15 分 钟 。 这 样 一 
来 ， 每 接 一 通电 话 就 会 浪费 20 分 钟 宝贵 的 工作 时 间 。 要 是 一 天 之 内 来 
10 通电 话 ， 光 消耗 在 这 上 面 的 时 间 就 有 半天 之 多 。 如 果 再 多 10 通 ， 那 
一 整 天 就 都 浪费 了 。 

在 这 样 的 职场 中 ， 很 多 时 候 我 们 在 规定 的 工作 时 间 内 什么 都 做 不 出 
来 ， 因 此 会 选择 加 班 。 这 就 给 人 一 种 晚上 写 代码 更 有 效率 的 感觉 ， 有 人 
甚至 觉得 在 家 写 代 码 才 有 效率 。 

更 严重 的 是 工作 被 打 断 时 我 们 会 产生 焦躁 情绪 。 每 次 想 集中 精力 工 
作 时 就 被 人 打 断 ， 任 谁 都 不 会 有 好 心情 。 明 明 马 上 就 能 沉浸 到 工作 之 中 
了 ， 结 果 却 被 强 拉 回 现实 。 即 使 想 进入 自己 的 世界 ， 一 个 不 怎么 重要 的 
事情 插 进来 也 会 让 我 们 前 功 尽 弃 。 

这 种 情况 如 果 持 续 下 去 ， 所 有 人 都 会 对 工作 感到 厌恶 ， 失 去 职场 的 
归属 感 。 不 仅 会 影响 每 天 的 工作 效率 ， 还 可 能 导致 人 才 流 失 。 

然而 从 管理 人 员 的 角度 来 看 ， 程 序 员 因 无 法 集中 精力 而 感到 焦躁 不 
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安 并 不 是 什么 大 问题 。 因 为 在 管理 人 员 的 日 常 工 作 中 ， 其 他 事情 不 断 插 
进来 是 家 常 便 饭 的 事 。 或 者 说 ， 他 们 的 工作 就 是 应 对 一 个 个 插 进 来 的 事 
情 。 所 以 管理 人 员 很 难 理解 程序 员 追 求 的 理想 状态 。 

一 旦 出 现 此 类 情况 ， 就 需要 对 职场 进行 意识 改革 和 文化 改革 了 。 在 
任何 条 件 下 ， 都 要 让 程序 员 能 在 连续 的 时 间 内 进行 工作 。 如 此 一 来 ， 就 
能 在 确保 编程 时 间 的 前 提 下 ， 很 好 地 分 配 时 间 和 调整 项 目 ， 同 时 还 能 营 
造 出 避免 语 境 切换 的 文化 。 















































;3EEUu 央 系统 思维 与 领域 驱动 设计 


系统 是 相互 作用 的 元 素 ( 部 分 ) 的 集合 ， 它 拥有 整体 的 功能 。 

系统 并 不 是 单纯 的 集合 ， 而 是 拥有 整体 功能 的 集合 ， 这 一 点 非常 重 
要 。 万 物 都 是 相互 联系 的 。 物 质 世 界 、 社 会 机 制 、 人 内 心 的 想法 、 计 算 
机 的 逻辑 …… 志 间 万 物 组 成 了 一 个 巨大 且 相 互联 系 的 现实 组 织 。 

没有 任何 东西 是 孤立 存在 的 。 所 有 东西 都 是 组 织 的 一 部 分 ， 都 是 周 
围 情况 、 上 下 文 等 语 境 的 一 部 分 。 

因此 ， 有 时 候 某 个 细小 的 事物 会 带 来 巨大 的 影响 。 反 过 来 ， 我 们 认 
为 至 关 重 要 的 东西 ， 其 带 来 的 影响 并 没有 想象 中 那么 大 。 输 入 和 输出 不 
一 定 成 正比 ,“ 不 对 称 的 影响 ” 正 是 非 线性 系统 的 一 个 显著 特征 。 

现实 世界 显然 是 非 线性 的 。 不 管 我 们 单独 拿 出 什么 东西 来 看 ， 它 都 
与 宇宙 的 一 切 相关 联 。 

比如 地 上 长 着 一 棵 树 ， 我 们 可 以 将 其 视 为 一 个 独立 的 物体 。 但 实际 
上 这 棵 树 至 少 与 两 个 循环 系统 存在 关联 ， 这 两 个 循环 系统 分 别 是 “树叶 
与 空气 ”“ 根 与 土 "。 树 既 不 一 成 不 变 ， 也 不 独立 存在 。 

更 有 趣 的 是 ， 就 连 观 察 某 个 系统 的 我 们 ， 也 不 是 单纯 的 观察 者 。 不 
管 我 们 是 否 发 觉 ， 身 为 观察 者 的 我 们 ， 其 实 也 是 系统 的 一 部 分 。 

系统 思维 这 种 思考 方法 就 是 让 我 们 在 考察 事物 时 运用 “系统 ”的 概 
念 ， 统 一 地 、 全 面 地 理解 对 象 整体 。 

系统 存在 边界 。 从 系统 内 部 的 某 一 结构 中 取出 部 分 元 素 进 行 分 析 ， 
并 不 能 让 我 们 理解 系统 整体 的 功能 和 行为 。 因 此 ， 为 了 了 解 对 象 的 整体 
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性 ， 系 统 思 维 不 仅 要 求 我 们 关注 结构 中 的 各 个 元 素 ， 还 要 求 我 们 关注 其 
中 的 关联 性 。 

要 想 用 软件 解决 问题 ， 除 了 要 具备 解法 〈 算 法 ) 相关 的 知识 ， 还 要 
对 问题 有 正确 的 认识 。 在 理解 问题 时 ， 需 要 用 到 系统 思维 ， 不 单 要 看 问 
题 本 身 ， 还 要 考察 问题 涉及 的 领域 一 一 语 境 。 

领域 驱动 设计 能 有 效 地 将 系统 思维 活用 到 软件 开发 之 中 。 这 里 的 领 
域 是 指 用 户 知 识 所 及 、 影 响 所 及 、 活 动 所 及 的 领域 ， 也 称 为 业务 领域 、 
攻 业 领域 或 问题 领域 。 总 之 ， 这 个 领域 指 的 是 软件 准备 解决 的 问题 ， 即 
“软件 的 语 境 ”。 

领域 驱动 设计 将 领域 建 模 后 形成 的 “领域 模型 ” 置 于 软件 开发 的 中 
心 位 置 。 程 序 员 与 领域 专家 组 成 团队 ， 将 通过 语言 、 图 和 代码 实现 的 
“交流 ”与 领域 模型 一 体 化 ， 并 在 此 过 程 中 反复 深化 领域 模型 。 通 过 这 
种 方式 来 创造 出 价值 更 高 的 软件 正 是 该 设计 思想 所 体现 的 内 容 。 

软件 一 旦 离开 领域 ， 就 失去 了 解决 领域 内 问题 的 能 力 ， 其 存在 意义 
将 受到 质疑 。 为 避免 这 一 情况 出 现 ， 我 们 应 尽力 摸索 领域 模型 ， 从 构建 
起 的 领域 模型 出 发 驱动 所 有 东西 。 这 样 一 来 ,我 们 就 能 做 出 可 以 反映 领 
域 的 具有 较 高 价值 的 软件 了 。 

不 过 ， 我 们 不 可 能 一 下 子 就 设计 出 完美 的 领域 模型 。 一 个 优秀 的 模 
型 必须 经 历 多 次 发 布 才能 真正 成 型 。 我 们 要 在 每 次 发 布 的 过 程 中 加 深 领 
域 相关 的 知识 ， 反 复 研究 建 模 ， 深 化 领域 模型 。 
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E33 后 后 区 潮 实 践 知识 与 整体 优化 


亚 里 士 多 德 将 知识 分 为 客观 知识 、 技 术 知 识 和 实践 知识 三 类 。 





e 客观 知识 

客观 知识 是 普遍 的 真理 ， 是 具有 普遍 正确 性 的 知识 。 这 类 知识 不 
被 时 间 与 空间 左右 ， 是 语 境 独立 的 、 客 观 的 知识 。 

客观 知识 用 通俗 的 话 来 讲 ， 就 是 科学 。 
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e 技术 知识 

技术 知识 是 实用 的 知识 或 技术 在 应 用 过 程 中 衍生 或 创造 出 的 技 
巧 。 技 术 知 识 与 客观 知识 的 明显 区 别 在 于 ， 技 术 知 识 是 依存 于 语 
境 的 知识 。 

技术 知识 用 通俗 的 话 来 讲 ， 就 是 工学 。 


实践 知识 

实践 知识 与 客观 知识 和 技术 知识 不 同 ， 我们 可 以 称 之 为 “知性 美 
德 "。 也 就 是 说 ， 实 践 知识 其 实 是 一 种 具有 实践 性 的 智慧 。 实 践 
知识 有 时 也 称 为 车 见 、 逻 辑 和 实践 智慧 等 。 

实践 知识 是 一 种 考虑 了 语 境 与 具体 情况 ， 能 够 具体 问题 具体 分 
析 ， 可 以 在 进程 中 根据 需要 调整 行动 目标 的 智慧 。 也 就 是 说 ， 实 
践 知识 是 从 实践 中 获得 的 高 质量 共识 ， 是 一 种 通过 对 价值 和 逻辑 
进行 高 度 判断 ， 在 时 刻 变 化 的 语 境 与 情况 中 采取 对 整体 最 有 利 的 





在 软件 开发 中 ,我 们 也 需要 根据 自己 的 能 力 与 价值 观 ， 在 具体 的 情 
况 下 向 用 户 提供 价值 。 因 此 我 们 需要 运用 实践 知识 ， 掌 握 语 境 ， 力 求实 
现 整体 的 优化 。 














;IE 避 关系 主义 与 故障 应 对 


用 于 解释 存在 的 思想 称 为 “存在 观 ”。 

关于 存在 观 ， 西 方 哲学 认为 首先 要 有 独立 存在 的 “实体 ”， 然 后 实 
体 与 实体 之 间 产 生 第 二 层 存 在 ， 即 “关系 ”。 

而 认为 “关系 ”是 第 一 层 存 在 ， 所 有 实体 都 是 “关系 的 结 节 ”的 思 
想 称 为 “关系 主义 ”。 

关系 主义 的 出 现 比 西方 哲学 早 ， 佛 教 哲 学 中 的 “缘起 ”就 属于 关系 
主义 。 存 在 观 曾 一 度 以 西方 哲学 为 中 心 ， 但 在 现代 ， 关 系 主义 也 渐渐 进 
入 存在 观 的 阵地 。 
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关系 主义 来 源 于 存在 观 ， 是 一 种 关注 元 素 与 元 素 的 关系 性 与 影响 的 
思维 方式 。 关 系 主 义 不 细 究 各 个 部 分 ， 而 是 重视 整体 现象 。 也 就 是 说 ， 
这 是 一 种 将 重心 放 在 语 境 上 的 思维 方式 。 

在 编程 领域 ， 这 一 思维 方式 在 应 对 故障 方面 有 很 好 的 效果 。 发 生 故 
障 时 ， 我 们 会 下 意识 地 以 错误 部 分 的 代码 为 中 心 进 行 排查 。 然 而 很 多 时 
候 故 障 发 生 的 根本 原因 并 不 在 这 里 。 

因此 ， 我 们 不 能 只 在 代码 中 寻找 原因 。 我 们 应 将 目光 转向 代码 与 库 
的 关系 、 代 码 与 执行 环境 的 关系 等 语 境 因 素 。 就 算 每 个 部 分 单独 拿 出 来 
看 都 是 正确 的 ， 只 要 关系 性 的 部 分 有 问题 ， 软 件 整体 就 是 欠 受 的。 

记 住 这 一 点 ， 故 障 排查 的 成 功率 将 大 幅 提 升 。 
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第 7 章 ”法则 


~ 编程 的 反 模式 ~ 


人 的 聪明 才智 不 在 于 经 验 的 多 少 ， 
而 在 于 应 用 经 验 的 能 力 的 强 弱 。 


一 一 萧 伯 纳 


布鲁克 斯 法 则 


英 语 Brooks’ law 





AAA 增 员 等 于 “ 火 上 浇 油 ” 








对 于 开发 进度 滞后 的 软件 开发 项 目 ， 如 果 为 了 赶 进度 而 在 开发 后 半 
程 添加 人 手 ， 反 而 会 使 延迟 情况 进一步 加 重 。 

在 项 目 尾 声 ， 当 我 们 发 现 产品 无 法 如 期 交付 时 ， 常 会 投入 更 多 的 人 
手 。 但 这 种 做 法 只 会 火 上 浇 油 。 





25 人 数 和 月 数 是 无 法 交换 的 





项 目的 工时 是 用 人 数 和 月 数 换算 的 ， 也 就 是 几 个 人 用 几 个 月 完成 某 
个 项 目 ， 所 以 用 “人 数 x 月 数 ”来 计算 项 目 工时 。 

这 里 要 注意 的 是 ， 该 乘法 运算 与 数值 的 乘法 运算 不 同 ， 人 数 和 月 数 
不 能 调换 。 也 就 是 说 , “人数 x 月 数 = 月 数 x 人 数 ” 的 式 子 是 不 成 
立 的 。 

比如 一 个 12 人 月 的 项 目 ， 客 户 要求 6 个 月 内 开发 完成 ,那么 我 们 
只 要 投入 2 人 即 可 。 如 果 人 数 和 月 数 可 以 调换 ， 那么 当 客 户 说 这 个 项 目 
比较 急 ， 需 要 在 2 个 月 之 内 完成 时 ， 我 们 只 要 投入 6 个 人 就 行 了 。 

然而 在 现实 中 ,“6 x2” 和 “2 x 6” 并 不 相同 。2 人 工作 的 效率 与 6 
人 工作 的 效率 不 可 同日 而 语 。 
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理由 如 下 。 


e 因 存 在 依赖 关系 而 产生 额外 的 负担 

如 果 每 个 人 的 工作 相互 独立 ， 那 么 在 人 数 是 原来 3 倍 的 情况 下 ， 
然而 一 般 来 讲 ， 工 作 分 割 之 后 ， 各 项 工作 之 间 会 产生 依赖 关系 。 
如 此 一 来 就 会 产生 一 些 新 的 负担 ， 如 任务 的 分 割 、 各 项 确认 工作 
的 出 现 以 及 通信 路 径 的 增加 等 。 

即便 追加 人 手 ， 这 些 额 外 的 负担 也 会 拖 慢 项 目的 进度 。 


e 培训 新 人 会 占用 一 定时 间 

在 追加 人 手 时 ， 为 了 能 让 这 些 人 发 挥 作用 ， 必 须 让 他 们 学 习 当 前 
项 目 国有 的 各 种 知识 、 信 息 以 及 技术 。 也 就 是 说 ， 要 花 时 间 对 新 
人 进行 培训 。 此 外 ， 负 责 培 训 的 人 是 同一 个 项 目 内 的 成 员 ， 这 就 
导致 新 团队 的 整体 生产 效率 下 滑 。 

在 新 人 真正 发 挥 作用 之 前 ， 整 个 项 目的 进度 都 是 滞后 的 。 


lA 二 重新 制订 时 间 表 


无 条 件 地 投入 更 多 人 手 来 赶 上 进度 是 一 种 不 明智 的 做 法 。 

强行 给 当前 成 员 增 加 负担 也 只 会 对 项 目 造 成 损害 。 

进度 滞后 最 好 的 解决 方法 是 重新 制订 时 间 表 。 在 此 过 程 中 ， 要 与 用 
户 做 好 协调 ， 同 时 决定 各 个 功能 的 优先 程度 ， 进 行 阶 段 式 发 布 。 
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局 生产 与 生 孩 子 


在 项 目 开 发 中 ， 增 加 程序 员 的 数量 并 不 代表 能 加 快 处 理工 作 的 速 
度 ， 缩 短 开发 时 间 。 

在 这 一 点 上 ， 开 发 的 生产 效率 与 生 和 孩子 很 像 ， 因 为 就 算 把 10 个 孕 
妇 凑 到 一 起 ， 妊 娠 过 程 也 不 可 能 缩短 到 一 个 月 。 

这 个 比喻 生动 形象 地 展示 了 生产 效率 不 是 单纯 的 劳动 力 相 加 。 














be 人 与 人 也 不 可 交换 





前 面 说 过 ， 人 数 与 月 数 不 可 交换 。 从 某 种 意义 上 讲 ， 人 与 人 也 是 不 
可 交换 的 。 

一 个 程序 员 离 开 了 ， 并 不 是 再 补 一 个 程序 员 就 行 。 之 所 以 这 么 说 ， 
是 因为 程序 员 的 水 平 参 差 不 齐 。 

在 物理 空间 内 的 生产 效率 方面 ， 有 能 力 的 人 与 没 能 力 的 人 之 间 的 差 
距 最 多 也 就 几 人 和信。 但 像 程序 员 这 种 以 信息 空间 为 主 战场 的 人 ， 由 于 不 
受 物理 方面 的 制约 ， 各 个 程序 员 之 间 的 生产 效率 有 很 大 的 差别 。 据 说 能 
差 30 倍 。 

不 过 ,“ 同 样 的 时 间 内 能 写 出 多 少 代码 ”这 种 生产 效率 上 的 差距 并 
不 是 造成 上 述 现 象 最 根本 的 因素 。 某 些 方面 的 差距 更 根本 且 更 巨大 。 

比如 以 下 几 个 方面 。 





























e 有 能 力 / 没 能 力 
有 些 人 写 出 的 代码 能 用 ， 有 些 人 写 出 的 代码 不 能 用 。 这 是 一 个 有 
与 无 的 比较 ， 计 算 差 距 已 经 没有 意义 了 。 


ebug 多 /bug 少 
有 些 人 写 出 的 代码 没有 bug， 有 些 人 写 出 的 代码 到 处 都 是 bug。 
二 者 的 维护 成 本 会 出 现 巨大 的 差别 。 
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e@ 执行 速度 快 / 执行 速度 慢 
有 些 人 写 出 的 代码 执行 速度 快 ， 有 些 人 写 出 的 代码 执行 速度 慢 。 
代码 的 执行 速度 慢 意 味 着 会 浪费 用 户 的 时 间 。 软 件 的 目的 是 实现 
业务 的 高 效 化 ， 为 用 户 节省 更 多 的 时 间 。 代 码 执 行 速 度 慢 的 话 就 


况且 ， 代 码 执 行 速度 慢 还 会 纪 


花 时 间 应 对 用 户 投诉 ， 


会 失去 用 户 的 信任 。 


代码 可 读 性 高 /代码 可 读 性 低 


| 来 用 户 的 投诉 。 这 时 ， 我 们 不 仅 要 


有 些 人 写 出 的 代码 可 读 性 高 ， 有 些 人 写 出 的 代码 可 读 性 低 。 
另外 ， 有 些 人 写 出 的 代码 便于 修改， 有 些 人 写 出 的 代码 一 经 修改 


就 会 出 问题 。 


二 者 由 此 产生 的 优化 成 本 大 不 相同 。 代 码 质量 差 到 一 定 程度 时 其 


至 无 法 优化 。 


宗 合 上 面 几 点 来 看 ， 有 能 力 的 程序 员 和 没 能 力 的 程序 员 确 实 差 出 好 


几 个 档次 。 


有 能 力 的 程序 员 在 项 目 中 起 到 的 作 月 
， 我 们 不 可 以 将 他 们 视 为 可 交换 的 “ 


ee 固定 的 职责 。 


站 二 反 模 式 





日 非常 大 。 对 于 这 些 有 能 力 的 程 
“1 人 月 ”"， 要 把 他 们 留 在 项 目 中 





从 成 功 的 软件 或 软件 开发 中 找 出 成 功 的 原因 ， 也 就 是 找 出 良性 的 
并 共享 ， 这 在 当今 已 经 是 很 常见 的 做 法 了 。 
利用 成 功 的 模式 ， 我 们 就 可 以 在 成 功 事 例 的 引导 下 ， 大 幅 节约 时 间 、 费 


(共同 ) 模式 ， 对 其 进行 分 类 j 





用 与 劳力 。 





























人 们 在 各 个 层级 收集 了 大 量 模式 。 其 中 较 具 代表 性 的 有 代码 设计 中 
的 “设计 模式 ”、 架 构 中 的 “企业 应 用 架构 模式 ”和 


织 模式 ”等 。 

















团队 编排 中 的 “组 
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另 一 方面 ， 人们 也 开始 从 失败 的 软件 或 软 从 























开发 中 寻找 失败 的 原 


因 ， 也 就 是 找 出 恶性 的 共同 模式 ， 对 其 进行 分 类 并 共享 。 为 了 与 良性 模 
式 进 行 区 分 ， 我 们 称 这 类 模式 为 “ 反 模 式 ”。 本 章 就 总 结 了 各 类 反 模 式 。 

反 模 式 用 作 “ 反 面 教 材 "， 也 用 作 “ 拐 杖 ”。 反 模式 是 “陷阱 ”的 
定义 集 。 了 解 了 反 模 式 ， 我 们 就 能 提早 发 现 问题 的 苗头 ， 防 患 于 未 然 。 














在 已 经 出 现 问 题 的 情况 下 ， 只 要 能 及 时 和 














方案 。 








认 ， 就 可 以 找到 合适 的 解决 
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康 威 定律 


英 语 Conway’s law 





架构 服从 于 组 织 结构 


软件 的 结构 ， 即 架构 ， 反 映 了 创建 它 的 组 织 的 结构 。 
比如 以 3 组 结构 创建 编译 器 ， 我 们 就 能 得 到 Three-Pass 编译 器 ; 以 
4 组 结构 创建 编译 器 ， 我 们 就 能 得 到 Four-Pass 编译 器 。 
3 组 4 组 


语法 入 
证 


代码 优化 


生成 代码 
































i 


架构 以 信息 交流 为 基础 


设计 软件 的 组 织 结构 倾向 于 在 设计 中 模仿 软件 的 信息 传递 结构 ， 
为 信息 交流 建立 在 组 织 结构 的 基础 之 上 ， 而 架构 建立 在 信息 交流 的 基础 
之 上 

可 以 说 ， 软 件 的 架构 是 由 组 织 结构 的 通信 路 径 形 成 的 。 
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过 5 习 先 设计 架 构 再 编排 组 织 结构 





在 什么 都 不 做 的 情况 下 ， 架 构 是 服从 于 组 织 结构 的 。 但 正确 的 做 法 
恰好 相反 。 也 就 是 说 ， 我 们 应 该 先 设计 一 个 好 的 架构 ， 然 后 根据 染 构 编 
排 组 织 结构 。 

依照 组 织 结构 设计 出 来 的 架构 ， 从 软件 的 观点 来 看 不 可 能 是 最 优 
的 。 这 种 架构 会 给 产品 的 质量 带 来 负面 影响 。 

但 是 ， 如 果 不 考虑 组 织 结构 ， 只 将 架构 调整 到 最 优 状态 ， 通 信和 路径 
又 会 发 生 错 位 。 因 为 这 时 组 织 结构 的 组 成 要 素 不 能 反映 软件 的 组 成 要 
素 ， 组 织 结构 间 的 关系 也 可 能 无 法 反映 软件 各 个 组 成 要 素 间 的 关系 。 在 
这 种 情况 下 ， 开 发 不 可 能 按照 预期 进行 。 因 此 ， 应 该 先 构建 架构 ， 然 后 
让 组 织 结构 从 属于 架构 。 

不 过 ， 早 期 创建 出 来 的 架构 只 是 一 个 半成品 ， 此 时 的 架构 并 不 稳定 。 
如 果 过 早 让 组 织 结构 从 属于 架构 ， 组 织 结构 就 会 跟 不 上 架构 的 变化 。 

所 以 ， 等 架构 得 到 充分 验证 之 后 再 构建 组 织 结构 的 做 法 比较 高 效 。 


组 织 结构 与 过 程 


组 织 结构 与 架构 之 间 相 互 依赖 的 关系 固然 重要 ， 但 我 们 也 不 能 忽略 
昌 织 结构 与 过 程 的 契合 度 。 
在 数据 库 组 、 主 框架 组 、Web 服务 器 组 和 测试 组 这 种 以 技术 领域 分 
的 组 织 结构 中 实践 敏捷 过 程 ， 显 然 比较 困难 。 
因为 这 些 根据 技术 分 出 来 的 组 ， 不 论 实现 什么 功能 ， 都 会 过 分 依赖 
其 他 组 的 工作 。 即 便 是 一 个 很 小 的 功能 ， 组 与 组 之 间 也 要 进行 大 量 的 交 
流 与 合作 ， 既 消耗 时 间 ， 又 影响 质量 ， 还 会 增加 成 本 。 

在 这 种 情况 下 ， 即 使 采用 了 敏捷 开发 ， 也 不 能 一 点 一 点 地 进行 发 
布 。 可见， 组 织 结 构 、 架 构 和 过 程 是 紧密 相连 的 ， 我 们 不 能 单独 拿 出 茶 
一 项 来 评判 好 与 坏 。 
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破 窗 效应 


= 


英 语 Broken Windows Theory 





二 此 不 好 的 代码 是 “ 蚁 穴 ” 


如 果 大 楼 这 类 建筑 物 上 有 一 局 长 期 未 被 修理 的 窗户 ， 这 栋 大 楼 就 会 
给 人 一 种 “被 遗弃 ”的 感觉 。 人 们 便 不 会 再 留心 这 栋 大 楼 的 状态 。 

这 样 的 话 ， 还 会 有 窗户 继续 碎 掉 。 接 着 是 垃圾 乱 倒 ， 满 墙 涂 鸦 。 别 
看 只 是 破 了 一 扁 窗 户 ， 如 果 放 置 不 管 ， 整 栋 建筑 也 会 遭 到 严重 的 破坏 。 

软件 也 会 发 生 这 样 的 事情 。 如 果 对 软件 的 “ 破 窗 ”， 也 就 是 那些 不 
好 的 设计 、 错 误 的 决定 或 不 好 的 代码 放置 不 管 ， 那 么 不 论 它 多 么 微 不 足 
道 ， 也 能 在 很 短 的 时 间 内 让 整个 软件 腐烂。 

















2 对 不 好 的 代码 会 带 来 收 念 





软件 中 一 旦 存在 “ 破 窗 "”， 程 序 员 的 脑 中 就 会 不 自觉 地 产生 “ 剩 下 
的 代码 表 定 也 是 一 团 糟 ， 随 便 改 一 改 算 了 ”的 想法 。 

关于 这 种 现象 ， 有 一 个 叫 作 “信箱 实验 ”的 著名 心理 学 实验 。 如 果 
自家 信箱 附近 的 墙壁 上 有 涂 获 ， 或 者 信箱 附近 有 垃圾 ， 那 么 该 信箱 中 信 
件 被 盗 的 概率 就 会 达到 25%。 仅 仅 是 一 些 垃圾 和 涂鸦 ， 就 能 将 许多 正直 
人 士 变 成 小 偷 。 

除了 从 众 心 理 之 外 ,我 们 也 可 以 用 “莫名 的 不 安 ” 这 种 心理 来 解释 
为 什么 会 出 现 这 种 现象 。 一 局 被 弃 之 不 管 的 破 窗 户 ， 会 让 人 产生 “在 这 
附近 遇 到 危险 的 话 肯 定 没 人 来 救 ”的 想法 ， 随 之 让 人 产生 不 安 的 情绪 。 
即便 是 一 些 细 枝 末节 的 东西 ， 如 果 总 是 以 一 种 没有 得 到 处 理 的 状态 摆 在 
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人 们 眼前 ， 也 会 让 人 渐渐 变 得 神经 质 ， 使 人 的 交感 神经 处 于 紧张 状态 ， 
甚至 促使 人 付 诸 暴力 。 
也 就 是 说 ， 出 现 这 种 现象 的 关键 原因 ， 与 其 说 是 “ 破 窗户 ”本 身 ， 
不 如 说 是 小 小 的 问题 被 弃 之 不 管 而 带 来 的 “不 安 "。 相 较 于 时 间 短 强度 
大 的 精神 压力 ， 人 们 对 时 间 长 强度 小 的 精神 压力 更 加 敏感 。 当 某 些 有 违 
社会 道德 的 现象 一 直 出 现在 我 们 的 眼前 时 ， 人 就 会 暴露 出 脆弱 性 。 












































[35 二 保持 代码 整洁 


我 们 不 能 对 代码 的 “ 破 窗 ”， 也 就 是 代码 不 好 的 部 分 放置 不 管 ， 要 
在 发 现 “ 破 窗 ” 的 时 候 立 即 进行 修补 。 没 有 了 “ 破 窗 "， 代 码 就 能 保持 
整洁 的 状态 ， 这 样 一 来 ， 程 序 员 便 会 小 心 缀 经 地 对 待 这 些 代码 ， 避 人 免 弄 
脏 它们 。 就 算 交 付 日 期 近 在 眼前 ， 也 没 人 愿意 当 第 一 个 和 弄 脏 代码 的 人 。 

另外 ， 如 果 没 有 足够 的 时 间 修 复 代 码 ， 至 少 要 简单 明了 地 指出 “这 
段 代码 不 好 ”。 

比如 对 于 自己 认为 不 好 的 地 方 ， 可 以 添加 带 标签 的 注释 以 显示 在 
IDE ( Integrated Development Environment， 集 成 开发 环境 ) 的 任务 列表 
里 。 这 人 么 做 的 目的 是 强调 这 些 不 好 的 地 方 已 经 得 到 了 管理 ， 防 止 损害 进 
一 步 扩 大 。 


人 会 模仿 人 


破 窗 效 应 既 与 “莫名 不 安 ” 的 心理 因素 有 关 ， 也 与 “反射 性 模仿 他 
人 行为 ”的 人 类 自身 特性 有 关 。 

心理 学 中 已 经 证 实 ， 人 类 在 婴儿 时 期 就 已 经 具备 “反射 性 模仿 他 人 
行为 ”的 特性 了 。 不 过 ， 这 个 特性 需要 有 足够 长 的 时 间 才 会 显现 出 来 。 
如 果 人 们 长 期 处 于 一 种 低 素 质 的 “习惯 性 怖 仿 ” 的 状态 ， 就 会 去 模仿 他 
人 不 好 的 行为 ， 最 终 陷 人 恶性 循环 ， 这 也 可 能 是 破 窗 效应 出 现 的 原因 。 

不 过 ,不 管 是 因为 “莫名 不 安 ” 还 是 “反射 性 模仿 他 人 行为 "， 及 
时 解决 不 好 的 代码 都 是 不 变 的 应 对 策略 。 
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炉 增 原理 


英 语 Law of entropy increase 





CA 代码 会 自然 而 然 地 开始 腐 坏 


焙 是 物理 学 术语 ， 表 示 体 系 的 混乱 程度 。 根 据 热力 学 法 则 ， 人 们 证 
明了 全 和 字 害 的 炳 处 于 增加 状态 。 

软件 开发 可 以 超越 大 部 分 的 物理 法 则 ， 却 逃 不 出 信 增 原理 的 束缚 。 
如 果 不 对 代码 进行 管理 ， 其 混乱 程度 就 会 不 断 加 深 ， 直 到 突破 极限 。 也 
就 是 说 ， 代 码 会 逐渐 转向 腐 坏 。 














AAA 代码 会 向 着 混乱 的 方向 转变 





代码 变 得 越 来 越 混 乱 是 软件 开发 中 自然 而 然 的 事情 。 

不 管 开 头 多 么 有 序 ， 只 要 过 上 一 阵子 ， 代 码 就 会 开始 腐 坏 。 就 像 生 
肉 放 和 久 了 会 变质 一 样 ， 随 着 时 间 的 推移 ， 代 码 的 腐 坏 程度 会 越 来 越 深 。 
腾 肿 的 代码 越 积 越 多 ， 使 得 维护 难度 不 断 增 大 。 用 不 了 多 和 久 ， 即 便 是 很 
小 的 修改 都 需要 耗费 大 量 劳力 ， 迫 使 我 们 不 得 不 重新 设计 软件 。 

在 这 种 情况 下 ， 重 新 设计 软件 很 难 一 帆 风 顺 。 如 今 的 软件 日 新 月 
异 ， 新 的 设计 必须 能 跟 得 上 时 代 的 变迁 才 行 。 

出 就 是 说 ， 我 们 就 算 有 非常 明确 的 目标 ， 也 难免 会 跟 不 上 步调 ， 
为 我 们 在 实际 工作 时 打 的 是 “移动 的 靶子 ”。 
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过 六 呈 抓 住 代码 腐 坏 的 征兆 
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代码 开始 腐 坏 时 有 几 个 征兆 。 不 要 放 过 这 些 征兆 ， 发 现 它 们 后 立刻 
处 理 。 





刻板 

刻板 指 不 容易 修改 代码 。 

仅仅 因为 一 处 修改 ， 就 需要 对 所 有 与 其 存在 依赖 关系 的 模块 进行 
修改 ， 我 们 称 这 种 代码 设计 为 刻板 的 设计 。 

刻板 的 设计 会 给 我 们 带 来 很 多 困扰 。 比 如 我 们 接 到 委托 ， 要 对 代 
码 做 一 个 很 简单 的 修改 ， 于 是 简单 调查 了 需要 修改 的 地 方 ， 预 估 
了 工作 量 。 然 而 在 实际 工作 时 ， 随 着 工作 的 推进 ， 我 们 还 是 要 对 
其 他 预想 之 外 的 地 方 进行 修改 。 结 果 ， 工 作 量 远 远 超出 预 估 ， 我 
们 只 能 在 规模 庞大 的 代码 中 追查 需要 修改 的 地 方 。 


脆弱 

脆弱 指 一 处 修改 会 对 其 他 部 分 的 代码 造成 很 大 损害 。 脆 弱 的 代码 
甚至 会 损坏 与 其 完全 不 相关 的 代码 。 因 此 ， 程 序 员 在 处 理 新 问题 
时 就 可 能 会 引发 其 他 问题 ， 这 就 使 程序 员 陷 入 追 着 自己 尾巴 跑 的 
状态 。 

毫 不 硅 张 地 说 ， 脆 弱 的 模块 并 不 罕见 。 这 类 模块 很 容易 辨认 。 那 
些 需要 经 常 修复 的 模块 、 常 年 出 现在 故障 列表 中 的 模块 、 程 序 员 
认为 需要 重新 设计 的 模块 ， 以 及 越 修复 质量 越 差 的 模块 等 就 属于 
脆弱 的 模块 。 





可 移植 性 差 

可 移植 性 差 指 软件 难以 移植 到 其 他 环境 中 。 

如 果 软 件 在 任何 环境 下 分 离 可 运行 部 分 和 依赖 环境 的 部 分 都 会 出 
现 困难 并 伴随 风险 ， 我 们 就 可 以 说 该 软件 不 具备 可 移植 性 。 


e 难以 掌控 

难以 掌控 指 代码 难以 掌控 和 开发 环境 难以 掌控 。 

代码 难以 掌控 是 指 设计 结构 不 具备 灵活 性 。 我 们 无 法 在 保持 设计 
结构 的 前 提 下 轻松 修改 难以 掌控 的 代码 。 相 较 于 能 保持 设计 结构 
的 方法 ， 使 用 投机 取 巧 的 方法 更 能 轻松 地 完成 修改 。 在 代码 难以 
掌控 的 状态 下 ， 做 错 事 容 易 ， 做 对 事 反 而 难 。 

而 开发 环境 难以 掌控 常 发 生 在 开发 环境 效率 低下 的 时 候 。 比 如 ， 
当 编译 需要 花费 大 量 时 间 时 ， 即 使 我 们 知道 已 经 无 法 保持 设计 结 
构 了 ， 还 是 会 倾向 于 采用 能 避免 大 规模 编译 的 修改 方式 。 如 果 提 
交 确认 两 三 个 文件 需要 花费 好 几 个 小 时 ,我 们 就 不 会 再 思考 保持 
设计 结构 的 方法 了 ， 而 是 会 寻找 更 节约 时 间 的 修改 方式 。 


e 复杂 

复杂 指 不 必要 的 元 素 过 多 。 

当 程 序 员 预 判 规格 说 明 书 会 发 生变 更 ， 在 代码 中 事先 埋 下 应 对 机 
制 时 ， 就 容易 使 代码 变 得 复杂 。 这 类 做 法 总 给 人 一 种 好 的 印象 。 
很 多 人 认为 预见 未 来 并 提早 做 出 准备 就 能 保持 代码 的 灵活 性 ， 防 
止 今后 苦于 修改 。 

然而 很 遗憾 ， 这 样 做 只 会 带 来 相反 的 效果 。 为 应 对 更 多 不 测 ， 我 
们 会 在 代码 中 留 下 大 量 一 次 都 用 不 上 的 结构 。 这 会 让 代码 变 得 复 
杂 ， 变 得 难以 理解 。 


e 重复 

重复 指 同样 的 代码 出 现 多 次 。 

在 写 文 档 时 ， 复 制 粘 贴 是 一 个 很 好 用 的 方法 ， 但 在 编辑 代码 时 ， 
使 用 复制 粘贴 则 会 招来 很 严重 的 后 果 。 在 代码 出 现 重复 的 情况 
下 ， 修 改 软件 将 成 为 一 项 劳 神 费 力 的 工作 。 如 果 在 重复 的 部 分 发 
现 故 障 ， 就 需要 修改 代码 中 所 有 相同 的 部 分 。 

况且 ， 代 码 有 时 候 看 上 去 相同 ， 但 实际 上 有 着 细微 的 差别 ， 这 时 
修改 方式 就 可 能 不 同 了 。 
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如 果 这 种 看 上 去 相同 但 存在 细微 差别 的 代码 在 软件 中 大 量 出 现 ， 
就 表示 程序 员 没 有 做 抽象 化 工作 。 如 果 能 找 出 所 有 重复 的 部 分 ， 
将 其 适当 抽象 化 ， 消 除 重 复 ， 系 统 将 更 容易 理解 且 更 容易 维护 。 


e@ 不 透明 

不 透明 指 代码 难以 理解 。 

代码 有 时 候 很 难 让 人 理解 。 而 频繁 修改 的 代码 会 随 着 时 间 的 流逝 
越 来 越 难 以 让 人 理解 。 

在 刚 写 完 代 码 时 ， 代 码 对 编码 者 本 人 来 说 是 非常 明了 的 ， 因 为 编 
码 者 沉浸 于 开发 ， 熟 悉 该 项 目的 每 个 地 方 。 然 而 过 一 段 时 间 再 回 
过 头 来 看 ， 编 码 者 就 会 觉得 自己 怎么 能 写 出 如 此 不 堪 的 代码 。 
为 了 防止 此 类 情况 发 生 ， 编 码 者 需要 站 在 代码 阅读 者 的 立场 思 
考 ， 写 出 别人 能 够 理解 的 代码 。 让 别人 来 看 自己 写 的 代码 是 一 个 
行 之 有 效 的 方法 。 


局 二 在 敏捷 开发 中 代码 不 容 腐 坏 


人 敏捷 开发 乐于 接受 变化 。 

在 敏捷 开发 中 ， 我 们 几乎 不 给 初期 设计 留 时 间 ， 因 为 初期 设计 会 随 
着 时 间 的 推移 不 断 劣 化 。 把 时 间 花 在 这 方面 得 不 偿 失 。 

男 一 方面 ， 在 敏捷 开发 中 ， 我 们 会 尽 可 能 地 让 设计 保持 简洁 ， 尽 可 
能 频繁 地 进行 单元 测试 和 验收 测试 。 

这 样 一 来 ， 设 计 就 能 保持 灵活 性 且 易 于 变更 。 敏 捷 开 发 这 一 开发 方 
式 能 利用 自身 的 灵活 性 持续 地 对 设计 进行 改善 ， 所 以 在 各 个 迭代 的 最 
后 ， 我 们 能 获得 最 符合 该 迭代 要 求 的 设计 。 





















































营造 不 允许 代码 腐 坏 的 团队 文化 











使 软件 变 得 混乱 不 堪 的 最 大 因素 是 项 目 活动 中 的 心理 学 ， 也 就 是 
文化 。 
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要 防止 代码 腐 坏 ， 就 需要 时 刻 注意 让 代码 保持 简洁 ， 不 然 会 出 现 各 
种 问题 ， 比 如 设计 过 剩 、 解 决 问题 的 方案 比 问题 本 身 还 要 环 手 、 不 注意 
本 质问 题 只 关注 罕见 问题 等 ， 使 代码 变 得 复杂 。 

是 否 重视 腐 坏 的 代码 取决 于 团队 文化 。 如 果 只 是 头痛 医 头 脚 痛 医 
脚 ， 容 许 腐 坏 的 代码 存在 ,代码 的 混乱 程度 就 会 迅速 加 重 。 为 了 防止 这 
一 情况 发 生 ， 作 为 团队 的 行动 方针 ， 应 该 鼓励 团队 成 员 在 发 现 腐 坏 代码 
时 立刻 进行 重 构 。 这 一 方针 是 以 代码 质量 为 先 的 。 要 营造 一 种 让 人 不 得 
不 这 样 做 的 氛围 ， 集 全 员 之 力 修改 问题 代码 ， 不 给 代码 留 腐 坏 的 机 会 。 
不 可 否认 ， 这 样 会 消耗 额外 的 时 间 与 成 本 ,但 如 果 能 让 代码 规避 腐 坏 的 
风险 ， 这 么 做 也 是 值得 的 。 
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80-10-10 原 则 


英语 80-10-10 rule 





ci 编程 没有 万 能 药 





我 们 在 用 高 水 平 的 工具 或 语言 开发 软件 时 ， 可 以 在 非常 短 的 时 间 内 
实现 用 户 80% 的 需求 。 而 在 剩 下 20% 的 需求 中 ， 有 10% 的 需求 需要 通 
过 一 定 努 力 才能 实现 ， 另 10% 则 完全 不 可 能 实现 。 

因此 ， 如 果 要 100% 满足 用 户 的 需求 ， 开 发 就 会 陷入 进退 两 难 的 
境地 。 

如 果 此 时 已 经 开发 一 部 分 内 容 了 ， 那 么 抛弃 原 有 工具 重新 开发 就 显 
得 不 切实 际 。 这 时 ， 我 们 就 得 放弃 使 用 工具 ， 用 最 策 拙 的 方式 来 满足 某 
部 分 需求 。 





























AAA 编程 的 问题 领域 太 广 











软件 行业 从 20 世纪 90 年 代 中 期 起 ， 举 整个 行业 之 力 花 费 十 几 年 做 了 
一 场 实验 。 实 验 内 容 是 创造 一 款 能 够 让 能 力 平庸 的 技术 人 员 的 生产 效率 飞 
跃 性 提升 的 “万 能 工具 ”"， 比 如 模型 驱动 开发 、4GL ( 第 四 代 语 言 ) 等 。 

实验 的 结果 显示 ， 使 用 单一 工具 很 难 在 所 有 领域 都 获得 完美 的 成 果 。 

人 们 创建 这 种 工具 是 为 了 开发 出 更 人 性 化 、 质 量 更 好 的 软件 。 因 
此 ,为 了 防止 能 力 平庸 的 技术 人 员 引 发 问题 ， 人 们 对 语言 施加 了 相当 强 
的 功能 限制 。 结 果 ， 工 具 产 生 了 自己 的 “防守 范围 ”。 

但 软件 要 处 理 的 问题 范围 是 无 限 大 的 。 用 一 个 工具 解决 所 有 问题 的 
“万 能 药 ” 路 线 显然 走 不 通 。 

























































































290 


过 Ai 恒 工具 要 用 在 合适 的 地 方 





要 记得 ， 软 件 开 发 没有 万 能 药 。 就 算 他 人 鼓吹 某 个 工具 如 何如 何 
好 ， 我 们 也 要 知道 世上 没有 完美 的 东西 。 

但 是 ， 精 确 到 某 个 领域 之 后 ， 我 们 确实 能 找到 一 些 各 方面 能 力 都 
很 均衡 的 高 水 平 工具 。 这 些 工具 能 帮 有 我 们 完成 很 多 工作 ， 并 通过 插件 的 
方式 代替 原来 的 一 些 策 办法。 这 类 工具 只 要 运用 得 当 ， 就 能 发 挥 很 大 的 
效果 。 

因此 ， 我 们 应 该 积极 导 和 工具。 不过， 盲目 相信 工具 并 不 可 取 ， 因 
为 这 么 做 会 影响 效率 。 

导入 工具 前 要 先进 行 模拟 开发 ， 
再 决定 是 否 正式 导入 。 



























































Cn 














认 工 具 的 适用 范围 及 效果 之 后 ， 


对 症 药 比 万 能 药 好 用 


软件 开发 中 没有 能 称 为 万 能 药 的 工具 。 但 是 ,我 们 可 以 根据 项 目的 
特征 制作 对 证 药 。 换 句 话 说， 就 是 通过 功能 强大 的 语言 + DSL 的 元 层 
来 创造 专用 语言 。 在 这 个 领域 中 ， 使 用 的 语言 最 好 是 动态 的 且 易 于 元 编 
程 的 语言 。 


E 寺 ;5 志和 加 80:20 原则 


有 一 个 原则 与 80-10-10 原则 的 名 字 很 像 ， 那 就 是 80:20 原则 ( 帕 雷 
托 法 则 )。 二 者 名 字 类 似 ， 但 内 容 大 不 相同 。 

80:20 原则 指 整体 的 20% 的 元 素 创 造 了 整体 的 80% 的 内 容 。 这 是 一 
种 在 自然 界 和 人 类 社会 中 常见 的 现象 ， 比 如 : 






































@ 20% 的 商品 创造 了 80% 的 销售 额 
@ 20% 的 道路 上 集中 了 80% 的 交通 量 
@ 占 人 口 总 数 20% 的 富裕 阶层 拥有 80% 的 社会 财富 
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@ 20% 的 功能 占用 了 80% 的 使 用 时 间 


编程 中 也 有 符合 该 原则 的 现象 ， 比 如 : 





@ 20% 的 代码 集中 了 80% 的 故障 
@ 20% 的 代码 消耗 了 80% 的 处 理 时 间 














a 


实 ， 代 码 存在 质量 及 性 能 的 “热点 ”。 找 到 这 些 热点 至 关 重 要 。 
为 了 方便 说 明 ， 我 们 用 了 20% 这 个 数值 ， 但 实际 上 这 个 数值 更 小 。 
故障 集中 的 地 方 是 质量 的 热点 。 因 此 ， 在 发 现 故 障 时 ， 应 审查 故障 
周围 的 代码 ， 编 写 单元 测试 ， 进 行 水 平 扩展 测试 ,集中 解决 问题 。 
另外 ， 需 要 花费 大 量 处 理 时 间 的 地 方 是 性 能 的 热点 。 我 们 应 通过 测 
试 检查 出 这 些 地 方 ， 先 从 这 些 地 方 开 始 进行 性 能 调 优 。 
























































出 处 
[1] 尼 尔 ' 福特 . 卓有成效 的 程序 员 [M]. 熊 节 , 译 . 北京 : 机 械 工业 出 版 社 ， 
2009. 
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约 书 亚 树 原 则 


英 语 Joshua Tree Principle 


简 写 JTP 





没有 名 字 的 东西 “不 可 见 ” 


曾经 有 这 么 一 个 人 ， 常 年 住 在 镇 子 上 的 他 某 一 天 在 图 书馆 里 阅读 植 
物 图 鉴 时 ， 认 识 了 一 种 名 叫 “ 约 书 亚 树 ” 的 植物 。 图 鉴 中 附 有 该 植物 的 
照片 ， 而 他 从 未 在 镇 上 见 过 这 种 植物 。 

然而 ， 在 离开 图 书馆 回 家 的 路 上 ， 他 发 现 镇 子 里 到 处 都 是 约 书 亚 
树 一 一 那 种 他 以 为 自己 从 没 见 过 的 树 。 

这 个 故事 告诉 我 们 ， 人 在 知道 某 个 东西 的 名 字 后 就 会 注意 到 这 个 东 
西 。 反 过 来 说 ， 如 果 某 个 东西 没有 名 字 (我 们 不 知道 名 字 )， 那 么 人 就 
很 难 注意 到 它 。 
































ziEA 知道 名 字 才 知道 其 存在 


事物 或 概念 以 有 名 字 ( 人 们 知道 它 的 名 字 ) 为 前 提 。 有 了 名 字 才 能 
让 人 们 知道 它 ， 才 能 将 信息 传达 给 别人 。 

对 肉眼 看 不 到 的 概念 类 事物 而 言 ， 名 字 尤 其 重要 。 这 是 因为 有 了 名 
字 之 后 ， 这 类 事物 才能 被 认 知 ， 才 能 被 人 重复 使 用 。 

比如 设计 模式 的 最 大 成 果 就 是 给 已 有 的 设计 穿 门 起 了 一 个 名 字 ， 供 
重复 使 用 。 





外 
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(i 对 使 用 通用 语言 








我 们 要 创造 语言 ， 然 后 在 团队 中 共享 。 

这 就 需要 用 到 通用 语言 ( Ubiquitous Language，UL ) 了 。 通 用 语言 
是 能 够 正确 表达 某 问题 领域 各 个 要 素 的 团队 共有 的 语言 。 因 为 是 共有 的 
语言 ， 所 以 在 团队 内 必须 实现 统一 。 指 代 同 一 个 东西 时 要 用 同一 个 词 
语 。 近 似 的 词语 会 招来 混乱 ， 我 们 不 允许 其 出 现 。 

在 没有 通用 语言 的 情况 下 ， 团 队 成 员 使 用 的 语言 会 各 不 相同 。 如 果 
每 个 人 使 用 的 是 自己 定义 的 语言 ， 语 言 之 间 就 会 产生 障碍 ， 有 时 候 甚至 
需要 翻译 。 这 样 一 来 ， 交 流 上 就 需要 花费 更 多 的 时 间 ， 意 思 的 传达 也 将 
变 得 模糊 。 

因此 ， 为 了 让 团队 凝聚 成 一 体 ， 我 们 需要 让 通用 语言 来 充当 粮 糊 的 
角色 。 在 能 正确 捕捉 问题 领域 的 高 价值 软件 设计 中 ， 通 用 语言 是 必 不 可 
少 的 要 素 。 

通用 语言 不 仅 要 用 在 平时 的 对 话 中 ， 还 要 用 到 代码 里 。 这 样 一 来 ， 
说 明文 档 和 代码 都 能 实现 统一 ， 都 变 得 易于 理解 。 

另外 ,我 们 要 反复 琢 麻 通用 语言 。 读 出 声 ， 或 者 落实 在 笔头 ， 多 找 
一 些 候补 选项 ， 并 从 中 提炼 出 合适 的 概念 与 词汇 
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E33 后 四 巴 别 塔 


巴 别 塔 是 《圣经 : 旧 约 》 的 《创世纪 》 中 出 现 的 巨塔 。 人 类 想 建设 
通天 的 高 塔 ， 却 遭 到 了 神 的 阻止 ， 最 终 失 败 。 根 据 该 典故 ， 后 人 用 “ 巴 
别 塔 ”来 讽刺 那些 不 切实 际 的 计划 。 

神 阻 止 人 类 建设 巴 别 塔 的 方法 是 打 乱 人 类 的 语言 。 神 降临 人 间 ， 见 
到 巴 别 塔 后 说 :“ 人 类 就 是 因为 有 通用 的 语言 才 做 出 这 等 事情 。 应 打 乱 人 
类 的 语言 ， 让 他 们 听 不 懂 对 方 说 的 话 。” 神 真 的 这 么 做 了 。 结 果 ， 语 言 
被 打 乱 的 人 类 陷入 混乱 ,被 迫 终止 塔 的 建设 ,分 散 到 世界 各 地 。 就 这 
样 ， 建 设 巴 别 塔 的 项 目 失败 了 。 

可 见 ， 要 想 让 项 目 成 功 ， 通 用 的 语言 必 不 可 少 。 
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第 二 系统 综合 征 


英 语 Second system syndrome 





二 人 第 二 次 发 布 总 会 出 现 功能 过 多 的 情况 


由 发 布 第 一 版 软件 的 程序 员 设 计 的 第 二 版 软件 会 成 为 最 危险 的 一 个 
版 本 。 
第 二 版 软件 有 功能 过 多 、 质 量 差 以 及 功能 的 使 用 体验 较 差 等 倾向 。 





导出 人 在 适应 开发 后 会 倾向 于 “多 功能 主义 ” 


在 开发 第 一 版 软件 时 ， 由 于 未 知 的 情况 很 多 ， 风 险 较 高 ， 所 以 我 
们 在 进行 判断 时 会 比较 慎重 。 即 便 想 到 了 好 的 功能 ， 也 会 留 到 下 一 次 再 
实现 。 

然而 ， 在 开发 第 二 版 软件 时 ， 我 们 掌握 了 更 多 的 信息 ， 也 有 了 自 
信 ， 所 以 倾向 于 把 之 前 保留 的 功能 以 及 新 想到 的 功能 一 股 脑 儿 加 进去 。 

添加 过 多 功能 之 后 ， 代 码 变 得 复杂 ， 不 易 维护 。 功 能 本 身 也 变 得 复 
杂 ， 使 用 体验 变 差 ， 结 果 添 加 的 功能 也 没 能 得 到 人 们 的 青睐 。 不 管 是 代 
码 还 是 实现 的 功能 ， 质 量 都 较 以 前 有 所 下 降 。 

另外 ,那些 暂时 保留 的 功能 在 第 一 版 软件 中 也 许 是 比较 实用 的 ， 但 
在 第 二 版 软件 中 ， 这 些 功 能 可 能 已 经 失去 了 必要 性 ， 或 者 落后 于 时 代 
了 。 也 就 是 说 ， 把 这 部 分 功能 放 到 第 二 版 软件 中 实现 是 一 种 浪费 时 间 的 
做 法 。 
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和 考虑 用 户 


程序 员 要 有 自制 力 ， 避 免 陷 入 多 功能 主义 的 怪圈 。 

要 做 到 这 一 点 ,一 个 有 效 的 做 法 就 是 重新 对 用 户 进行 定义 并 将 用 
Dea 程序 员 对 用 户 的 印象 都 
会 对 程序 员 的 判断 产生 影响 。 这 就 给 程序 员 添 加 新 功能 的 欲望 带 上 了 
“ 柳 锁 ”。 

具体 做 法 就 是 在 编程 时 多 想 想 以 下 问题 。 












































@ 用 户 是 谁 

@ 用 户 需要 什么 

@ 用 户 认 为 什么 是 必要 的 
@ 用 户 想 要 什么 


扩展 第 二 系统 后 综合 征 











前 面 说 程序 员 容易 在 第 二 版 软件 中 产生 多 功能 主义 的 倾向 ,但 实际 
上 ， 第 二 版 以 后 的 版 本 也 会 出 现 同样 的 情况 。 

特别 是 数据 包 软件 等 需要 持续 发 布 的 软件 ， 随 着 一 次 次 版 本 升级 ， 
没 用 的 功能 会 越 来 越 多 。 

出 现 这 种 现象 的 原因 可 能 是 用 户 群 体 不 固定 ， 程 序 员 很 难 对 用 户 进 
行 具象 化 。 而 且 功 能 一 旦 发 布 就 很 难 有 机 会 删除 ， 所 以 只 能 越 积 越 多 。 

和 否认， 添加 功能 可 以 提升 软件 的 魅力 。 但 是 ， 相 较 于 新 功 

能 ， 用 户 往往 希望 基本 功能 是 稳定 的 ， 或 者 基本 功能 的 使 用 体验 能 得 到 















































功能 的 过 分 扩张 不 能 全 部 归罪 于 程序 员 的 一 己 私欲 ， 毫 无 原则 地 满 
足 用 户 的 需求 也 是 重要 原因 之 一 。 
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无 条 件 满 足 用 户 的 愿望 ， 就 会 在 软件 中 增加 大 多 数 用 户 用 不 到 的 功 
能 ， 还 要 准备 用 于 控制 该 功能 的 复杂 的 设置 画面 以 及 相关 设置 文件 。 如 
此 一 来 ， 软 件 就 会 变 得 难以 维护 ， 故 障 频 出 。 

这 种 功能 肆意 增多 的 现象 称 为 功能 草 延 ( feature creep )， 该 现象 意 
味 着 软件 开始 迈 向 破灭 〈 或 者 已 经 破灭 了 )。 

软件 设计 的 终极 之 美 是 “简单 ”。 越 是 简单 优质 且 拥 有 众多 用 户 的 
软件 ， 越 容易 出 现 更 多 的 需求 。 如 果 忠 实地 满足 这 些 需 求 ， 将 所 有 功能 
都 开发 出 来 ， 软 件 将 失去 简单 性 ， 变 成 一 款 没 人 用 的 软件 。 这 时 我 们 就 
会 陷入 进退 两 难 的 豁 境 。 

避免 出 现 这 种 悲剧 的 关键 是 要 有 勇气 对 需求 说 “NO”。 对 于 那些 与 
软件 核心 无 关 、 需 要 与 其 他 软件 组 合 才能 实现 的 功能 ， 我 们 要 明确 地 说 
“NO”。 只 有 这 样 ， 才 能 产生 优秀 的 设计 ， 才 能 让 软件 保持 简单 性 。 

不 过 ， 有 时 候 我 们 很 难 拒绝 用 户 强 烈 的 诉求 。 这 时 ， 我 们 不 要 直接 
在 软件 主体 中 实现 该 功能 ， 而 是 要 围绕 软件 主体 进行 扩展 ， 或 者 以 插件 
的 形式 在 不 改变 软件 核心 代码 的 前 提 下 修改 软件 的 运行 模式 ， 以 此 来 保 
持 软件 主体 的 简单 性 。 
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重新 发 明 车 轮 


英 语 Reinvented wheel 


Reinventing the wheel 





<iEA 制 作 已 有 的 东西 





有 时 候 对 于 某 种 功能 ， 明 明 有 现成 的 代码 或 库 可 以 使 用 ， 人 们 却 还 
要 自己 重新 开发 相同 的 功能 。 这 就 像 专门 花 时 间 又 重新 发 明 一 遍 世 上 早 
就 有 的 车 轮 一 样 ， 是 一 种 无 用 功 。 

有 现成 的 东西 ， 却 要 去 重新 发 明 一 个 ， 这 是 在 浪费 时 间 。 当 开发 规 
模 足 够 大 时 ， 其 危害 也 是 非常 大 的 。 想 要 一 个 “能 运行 各 种 服务 的 服务 
器 "， 于 是 专门 把 Web 服务 器 这 种 规模 极 大 的 软件 重新 开发 了 一 忆 。 这 
种 做 法 会 浪费 非常 多 的 时 间 。 

而 且 在 大 部 分 情况 下 ， 相 较 于 重新 发 明 出 来 的 东西 ， 既 有 产品 的 质 
量 更 好 。 比 如 相 较 于 我 们 现 写 出 来 的 库 ， 既 有 的 标准 库 更 好 ， 因 为 它 不 
仅 能 反映 出 提供 标准 库 的 专家 的 知识 ， 还 能 反映 出 人 们 在 使 用 过 程 中 积 
累 的 经 验 。 标 准 库 还 有 一 个 好 处 ， 那 就 是 就 算 我 们 什么 都 不 做 ， 随 着 时 
间 的 推移 ， 其 中 的 故障 、 功 能 和 性 能 也 会 自行 改善 。 

另外 ， 如 果 忽 视 标准 规格 ， 根 据 自 己 的 协议 编写 代码 ， 将 来 就 只 能 
走 自己 的 路 线 了 。 仅 人 靠 本 地 的 几 个 程序 员 是 不 可 能 跟 得 上 世间 的 主流 
的 。 另 外 ， 由 于 所 有 的 插口 都 是 独创 的 ， 所 以 将 来 也 无 法 实现 替换 。 


































































































2 和 不 知道 车 轮 和 想 制作 车 软 


重新 发 明和 车轮 的 原因 有 以 下 两 种 。 
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e 不 知道 车 轮 
程序 员 不 知道 车 轮 的 存在 。 也 就 是 说 ， 这 种 发 明 不 是 程序 员 有 意 


这 归咎 


总 


于 程序 员 的 知识 不 足 和 学 习 不 足 。 编写 与 语言 标准 库 功 能 


相同 的 代码 ， 或 者 在 有 标准 协议 的 情况 下 用 独创 的 格式 编写 通信 
功能 的 代码 等 都 属于 这 种 情况 。 


e 想 制 作 车 轮 
程序 员 有 制作 车 轮 的 欲望 。 也 就 是 说 ， 这 种 发 明 是 程序 员 有 意 而 


为 的 。 


这 是 一 种 叫 作 “ 非 我 发 明 ”(Not Invented Here，NIH ) 综合 征 的 
问题。 具体 表现 为 茶 个 东西 原本 没有 重新 制作 的 必要 ， 程 序 员 却 
出 于 对 技术 的 兴趣 或 排斥 他 人 制作 的 东西 而 想 重 新 制作 一 遍 。 


怎么 做 





关注 车 轮 之 外 的 东西 


我 们 要 避免 重新 发 明 车 轮 ， 将 重点 放 在 本 来 应 该 做 的 工作 上 。 
为 此 ， 在 编写 代码 之 前 ,一 定 要 先 确 认 是 否 存在 相同 功能 的 标准 


库 、 开 源 库 ， 
另外 ， 要 





























是 否 存 在 标准 协议 等 。 








借助 团队 会 议 等 机 会 从 其 他 程序 员 处 获取 信息 。 这 样 就 能 


避免 团队 内 出 现 重复 劳动 的 情况 。 


同时 , 在 





团队 中 彻底 清除 利己 主义 的 思想 。 


因为 想 做 而 做 ， 这 是 程序 员 自 私 的 一 面 。 然 而 ， 软 件 的 目的 不 是 满 
足 程序 员 的 欲望 ， 而 是 满足 用 户 的 需求 。 为 了 用 户 ， 为 了 在 质量 、 开 发 
时 长 和 费用 等 方面 做 到 最 好 ， 我 们 应 该 时 常 调查 哪些 东西 可 供 使 用 ， 掌 

















握 高 质量 的 开源 工具 或 商用 工具 。 
用 5 江 庆 允许 重新 发 明 车 轮 的 情况 


有 时 我 们 也 需要 大 胆 地 重新 发 明 车 轮 。 
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商业 目的 

商业 上 的 核心 部 分 必须 由 自己 制作 。 

在 使 用 已 有 的 东西 时 ， 必 然 会 对 该 部 分 产生 依赖 。 依 赖 则 意味 着 
对 该 部 分 失去 了 控制 权 。 

即便 知道 其 中 潜藏 着 致命 的 问题 ， 我 们 也 无 法 主动 去 修改 。 就 算 
可 以 委托 他 人 修复 ， 何 时 能 够 发 布 ， 是 否 真 的 能 得 到 改善 ， 都 是 
未 知 数 。 质 量 和 交付 期 方面 的 问题 很 可 能 在 商业 上 造成 无 可 挽回 
的 损害 。 

况且 ， 使 用 已 有 的 东西 就 意味 着 放弃 该 部 分 的 “差别 化 "。 因 此 ， 
商业 上 的 核心 部 分 ， 从 原则 上 来 讲 都 应 该 由 自己 制作 。 只 有 自己 
制作 出 这 部 分 内 容 ， 并 且 花 心思 做 出 个 性 ， 从 中 积累 经 验 ， 才 能 
开发 出 独特 的 、 能 贡献 于 世界 的 软件 。 


学 习 目 的 

要 成 为 优秀 的 程序 员 ， 就 得 不 断 积 累 高 质量 的 经 验 。 

软件 开发 的 模式 、 设 计 和 编程 等 方面 的 好 书 有 很 多 ， 然 而 读书 和 
实践 之 间 有 很 大 的 差别 。 

同样 ， 借 用 已 有 的 代码 与 自己 从 零 设 计 、 测 斌 软件， 解决 故障 ， 
提高 软件 质量 得 来 的 经 验 有 天 壤 之 别 。 

不 过 ， 有 机 会 编写 软件 核心 部 分 代码 的 程序 员 少 之 又 少 。 大 部 分 
程序 员 只 能 借用 已 有 代码 。 在 这 种 情况 下 ， 我 们 不 知道 代码 内 部 
是 如 何 运作 的 ， 因 此 和 使 用 “黑箱 ”没什么 区 别 。 

只 看 水 面 的 话 ， 我 们 是 无 法 得 知 水 下 隐藏 着 何 种 危险 的 。 如 果 不 
知道 水 底 究 竟 发 生 了 什么 ， 就 不 能 灵活 运用 水 流 。 自 己 亲 手 制作 
是 一 种 必要 的 经 历 。 为 此 而 “重新 发 明 车 轮 ” 是 程序 员 学 习 、 提 
高 技术 非常 有 效 的 一 个 方法 。 

当然 ， 我 们 免不了 失败 ， 但 这 种 经 历 也 比 直接 拿 现成 的 使 用 要 宝贵 。 
亲手 从 零 开 始 写 代码 ， 进 行 各 种 尝试 ， 从 一 次 次 失败 中 学 习 ， 能 
带 来 不 同 于 阅读 技术 类 图 书 的 好 处 。 不 过 ， 读 书 与 实践 同等 重 
要 ， 它 们 对 程序 员 来 说 都 是 不 可 或 缺 的 。 
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给 尾 牛 蕴 毛 


英 语 Yak Shaving 





向 抓 不 住 问题 的 本 质 





有 种 家 畜 叫 尾 牛 。 它 是 牛 的 一 种 ， 特 征 是 身上 长 着 厚 厚 的 毛 。 每 当 
临近 夏天 ， 履 牛 就 需要 弟 毛 。 我 们 需要 给 特 牛 刹 去 相当 多 的 毛 才 能 让 它 
的 皮肤 露出 来 。 

我 们 处 理 某 些 问 题 时 就 像 给 恬 牛 羊毛 一 样 ， 在 解决 问题 的 过 程 中 总 
会 有 新 的 问题 胃 出 来 ， 让 我 们 难以 抓 住 问题 的 本 质 。 

这 种 状态 如 果 持 续 太 久 ， 人 们 就 可 能 会 忘记 原本 要 解决 的 问题 是 
什么 。 























问题 会 接二连三 地 出 现 


问题 总 是 接二连三 地 出 现 。 
假设 我 们 想 导 入 在 Web 服务 右上 运行 的 任务 自动 化 工具 ， 以 提高 工 
作 效 率 。 








“ 先 下 载 Web 服 务 器 程序 。” 
“文件 太 大 了 ， 没 有 办 法 下 载 。” 
“ 那 就 导入 下 载 工具 。” 

“下 载 工 具 怎 么 不 运行 咱 ?” 
“原来 需要 前 置 模块 啊 。” 

“ 那 就 下 载 前 置 模块 。” 
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“需要 注册 用 户 。” 

“ 那 就 注册 一 个 吧 。” 

“ 恋 ? 用户 注册 页 面 不 动 了 。” 

“原来 是 浏览 器 版 本 太 老 了 。” 

“升级 了 浏览 器 ， 注 册 了 用 户 ， 模 块 也 下 载 好 了 。” 
“怎么 下 载 工具 还 是 不 运行 ? ” 

“哎呀 ， 需 要 操作 系统 的 补丁 包 。” 

(后 面 依然 没完 没 了 。) 





这 种 像 给 性 牛 弟 毛 一 样 的 情况 会 造成 时 间 上 的 浪费 。 有 时 候 ， 就 算 
我 们 预 估 了 工作 所 需 时 间 ， 也 没有 办 法 在 预 估 的 时 间 内 完成 工作 ， 这 种 
情况 发 生 的 原因 就 是 我 们 把 时 间 耗 费 在 了 给 性 牛 剃 毛 上 。 

另外 ,在 给 尾 牛 剃 毛 的 状态 下 ， 人 非常 容易 积攒 压力 。 我 们 很 难 推 
测 出 需要 花 多 长 时 间 才 能 把 特 牛 身上 的 长 毛 剃 光 。 如 果 这 种 无 法 达成 目 
标的 状态 一 直 持 续 下 去 ， 人 就 会 产生 挫败 感 。 


RF 


当 我 们 发 觉 自己 已 经 陷入 给 尾 牛 弟 毛 的 状态 时 ， 应 停 下 脚步 ， 回 想 
自己 原本 要 实现 的 目标 是 什么 。 如 果 发 现 自 己 已 经 偏离 了 目标 , 或 者 从 
时 间 、 成 本 的 角度 来 看 不 适合 再 继续 操作 下 去 了 ， 应 立刻 停止 工作 。 因 
为 在 这 种 情况 下 ， 寻 找 其 他 出 路 往往 会 带 来 更 好 的 结 

另外 ， 为 防止 其 他 人 也 陷入 同样 的 状态 ， 我 们 应 将 整个 过 程 分 享 给 团队 
成 员 。 在 一 个 全 员 共 享 的 空间 留 下 一 份 笔记 ， 能 够 防止 他 人 浪费 时 间 。 


















































Ee 勇于 面 对 “ 给 尾 牛 剃 毛 ” 


一 般 来 说 ， 见 到 要 给 尾 牛 剃 毛 的 情况 应 该 绕 着 走 。 但 是 ， 出 于 一 些 
有 价值 的 目的 ， 或 者 因为 紧急 故障 等 ， 有 时 我 们 必须 跨越 “给 尾 牛 弟 
毛 ” 的 障碍 ， 解 决 问题 。 
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这 个 时 候 最 麻烦 的 是 我 们 大 脑 解 决 问题 的 速度 跟 不 上 问题 出 现 的 速 
度 。 由 于 前 一 个 问题 尚未 解决 就 冒 出 了 下 一 个 问题 ， 所 以 我 们 的 大 脑 在 
解决 问题 时 往往 像 使 用 栈 一 样 ， 先 让 问题 入 栈 ， 再 一 个 一 个 出 栈 解决 
(同时 让 继 发 的 新 问题 和 人 栈 )。 这 就 是 给 性 牛 弟 毛 的 状态 。 在 这 种 情况 
下 ， 问 题 通常 会 接二连三 地 发 生 ， 出 栈 速 度 赶不上 入 栈 速度 ， 导 致 脑 内 
栈 溢出 。 

为 防止 这 类 情况 发 生 ， 我 们 要 记 住 不 能 只 在 脑 中 解决 问题 。 应 当 把 
问题 写 下 来 ， 一 个 一 个 地 解决 。 









































be 编程 中 的 “给 尾 牛 弟 毛 ” 














给 性 牛 剃 毛 的 情况 常 出 现在 搭建 环境 的 过 程 中 。 不 过 ， 编 程 中 也 会 
遇 到 类 似 的 情况 。 

比如 ， 在 写 代 码 时 ， 由 一 个 问题 联想 到 其 他 问题 ， 离 最 初 要 解决 
的 问题 越 来 越 远 。 在 最 坏 的 情况 下 ， 我 们 甚至 会 忘记 最 初 或 中 间 想 到 的 
问题 是 什么 。 

又 比如 ， 在 读 代码 时 ， 由 于 代码 未 整理 ， 所 以 我 们 很 难 找到 当初 想 
知道 的 东西 。 在 梳理 错综复杂 的 调用 关系 时 ， 一 不 小 心 就 会 忘记 代码 读 
到 了 哪里 ， 或 者 读 代码 的 目的 是 什么 。 

为 防止 这 类 情况 发 生 ， 我 们 在 读 写 复 杂 的 代码 时 ， 要 一 边 做 记录 一 
边 操作 。 特 别 是 在 写 代 码 时 ， 我 们 需要 思考 的 部 分 比 实 际 操作 的 部 分 要 
多 ,不 做 记录 的 话 就 可 能 会 有 陷入 循环 思考 的 状态 。 
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后 记 


在 本 书 的 最 后 ， 笔 者 将 主题 从 “编程 ”上 升 到 “做 人 ”， 为 大 家 介 
绍 三 个 原则 。 








第 一 个 原则 是 “关怀 ”， 出 自 现 代 哲 学 家 梅 洛 夫 的 著作 《关怀 的 
力量 》 

关怀 从 字面 意思 上 讲 ， 就 是 关心 他 人 。 

关心 他 人 是 指 帮助 对 方 成 长 并 实现 自我 ,但 关怀 的 意义 不 止 于 此 。 
除了 帮助 他 人 成 长 之 外 ， 帮 助 自 己 成 长 也 是 关怀 的 意义 之 一 。 帮 助 他 人 
实现 自我 有 助 于 自身 的 自我 实现 。 

注意 ,不 是 为 了 让 自己 实现 自我 而 去 帮助 他 人 ， 而 是 帮助 他 人 成 长 






































可 以 完成 自身 的 自我 实现 。 
关怀 的 对 象 不 一 定 是 人 。 比 如 艺术 家 就 可 以 把 作品 当成 关怀 的 
对 象 。 











对 程序 员 而 言 ， 关 怀 的 对 象 是 代码 和 读 代码 的 人 。 程 序 员 要 精心 编 
写 代码 ， 要 写 出 能 让 人 轻松 读 懂 的 代码 。 

“ 易 懂 ”属性 能 帮助 代码 成 长 ， 同 时 给 读 代码 的 人 带 来 方便 。 

这 些 关怀 最 终 会 回报 到 自己 身上 。 

第 二 个 原则 是 “道德 法 则 ”， 出 自 近 代 哲 学 家 康德 的 著作 《实践 理 
性 批判 六 

道德 法 则 是 制约 人 类 道德 行为 的 普遍 标准 。 这 一 基准 以 “你 这 样 行 
动 ， 使 你 意志 的 准则 始终 能 够 同时 成 为 普遍 立法 的 原则 ”的 命题 形式 来 
表现 。 

说 得 通俗 一 点 ， 就 是 采取 行动 前 先 问 一 下 自己 这 个 行动 能 否 获 得 众 
人 认可 ， 如 果 能 ， 则 立即 执行 。 
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该 法 则 延伸 出 了 很 多 法 则 ， 这 些 法 则 都 有 一 个 核心 的 内 容 ， 那 就 是 
人 要 永远 把 自己 人 格 中 与 他 人 人 格 中 共有 的 人 性 作为 目的 ， 决 不 可 单独 
将 其 用 作 手 段 。 

不 论 是 自己 还 是 他 人 ， 人 这 种 生物 ， 都 拥有 无 可 替代 的 人 格 。 人 格 
不 应 作为 手段 来 使 用 。 人 和 人 之 间 也 不 可 以 将 对 方 的 人 格 视 为 手段 。 我 
们 要 把 自己 以 及 对 方 的 人 格 看 作 目 的 。 

程序 员 必 须 记得 ， 软 件 的 用 户 和 自己 一 样 都 是 拥有 人 格 的 人 类 。 用 
户 与 程序 员 的 关系 不 是 互相 利用 ， 而 是 互相 为 对 方 做 出 贡献 。 
用 户 有 用 户 的 目的 ， 软 件 就 是 为 了 达到 用 户 的 目的 而 开发 的 。 程 序 
员 应 在 用 户 以 及 用 户 使 用 软件 的 方法 上 多 花心 思 ， 开 发 出 能 满足 用 户 需 
求 的 有 用 的 软件 。 










































































第 三 个 原则 是 “中 庸 "， 出 自古 代 哲 学 家 亚 里 士 多 德 的 若 作 《 尼 各 
马 可 伦 理学 》。 

“中 庸 ”是 调节 人 类 行为 及 感情 中 过 剩 部 分 与 不 足 部 分 的 “ 德 "。 这 
个 “ 德 ” 指 对 待 任 何事 情 都 不 走 极 端 ， 以 恰到好处 的 平衡 之 道 来 应 对 各 





























比如 ， 将 中 庸 之 道 用 在 应 对 怒 怖 情况 上 时 就 是 “ 拿 出 勇气 ”。 超 过 
中 庸 这 条 线 就 是 “ 蛮 勇 "， 没 有 达到 这 条 线 则 是 “ 层 情 ”。 

在 软件 开发 现场 ， 很 少 有 答案 非 此 即 披 的 问题 。 存 在 标准 答案 的 问 
题 少 之 又 少 。 解 决 方案 的 选项 都 是 “渐变 色 ”。 

黑 与 白 之 间 存 在 着 无 数 种 浓淡 不 同 的 灰色 ， 因 此 不 存在 黑白 两 端 二 
选 一 的 情况 。 

我 们 要 认识 到 解决 方案 的 选项 是 “渐变 色 ” 的 事实 ， 并 以 “选择 哪 
种 浓度 的 灰色 ”的 思考 方式 来 对 待 问题 。 

为 此 ， 掌 握 “ 语 境 ” 就 显得 至 关 重 要 。 我 们 要 以 从 语 境 中 得 来 的 信 
息 为 基础 ， 找 准 平衡 点 ， 选 择 最 合适 的 “灰色 ”。 

以 上 就 是 三 个 做 人 方面 的 原则 。 

程序 员 写 出 来 的 代码 会 有 人 读 ， 开 发 出 的 成 品 软件 也 会 有 人 用 。 在 
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应 照顾 到 这 些 人 ， 掌 握 语 境 ， 做 出 最 为 平衡 的 选择 。 
状态 "。 如 果 是 这 


编写 代码 时 ， 
到 此 ， 所 有 原则 就 介绍 完了 。 
展示 了 世间 万 物 不 过 是 一 种 “信息 

这 是 一 个 有 无 限 可 能 


自然 科学 成 果 
样 ， 那 么 负责 处 理 信息 的 程序 员 可 以 说 身 担 重任 。 
且 十 分 有 意义 的 职业 
衷心 希望 本 书 能 给 各 位 程序 员 带 来 启发 ， 帮 助 大 家 写 出 更 好 的 代 
码 ， 开 发 出 更 好 的 软件 。 同 时 希望 本 书 能 社会 市 来 好 的 影响 。 
上 有 田 勋 
2016 年 1 月 























给 整个 











山 


[1] Milton Mayeroff. On Caring[M]. New York: William Morrow Paperbacks 





















































出 处 
1990. 
[2] 御 子 柴 善 之 . 自分 忒 考 元 久 勇 气 一 一 力 沁 卜 哲 学 入 门 [M]. 东京 : 岩 波 叫 
店 , 2015. 
[3] 亚 里 士 多 德 . 尼 各 马 可 伦 理学 [M]. 邓 安 庆 , 译 . 北京 : 人 民 出 版 社 , 2010. 








314 


让 谢 辞 人 





首先 ， 衷 心 感谢 秀和 系统 编辑 部 的 责任 编辑 ， 使 原本 杂乱 无 章 的 信 
息 升华 为 有 益 于 读者 的 文章 ， 最 终 成 就 了 本 书 的 出 版 。 











感谢 诸多 技术 图 书 和 技术 杂志 的 出 版 方 。 吕 人 的 所 有 知识 全 来 自 于 
各 出 版 方 出 版 的 图 书 和 杂志 。 特 别 是 其 中 介绍 的 各 个 原则 让 我 受益 菲 
浅 , 我 也 因此 而 成 长 许多 。 
感谢 在 网 络 上 公开 技术 信息 的 各 位 。 如 果 没 有 好 书 介绍 、 学 习 方 法 
介绍 等 信息 ， 我 恐怕 无 法 看 清 前 路 ， 至 今 仍 感到 迷茫 。 另 外 ， 若 不 是 各 
位 提供 了 关于 编程 的 具体 信息 ， 我 也 不 可 能 写 出 代码 。 
感谢 阅读 却 人 博客 的 各 位 。 大 家 来 读 我 的 博客 是 对 我 的 鼓励 ， 我 也 
因此 维持 了 较 高 的 学 习 效率 。 
感谢 各 位 团队 成 员 一 直 以 来 对 我 的 帮助 。 能 够 开发 出 好 的 产品 ， 以 
及 能 让 本 书 有 如 此 丰富 的 内 容 ， 都 是 各 位 的 功劳 。 


















































感谢 生 我 养 我 的 父母 。 正 因为 有 你 们 ， 我 才 有 今天 。 


最 后 致 我 的 妻子 。 

虽然 你 是 编程 方面 的 外 行人 ， 但 还 是 为 我 的 文章 做 了 校对 工作 ， 谢 
谢 你 。 你 准确 指出 了 我 笔 误 的 地 方 以 及 文章 中 的 一 些 漏洞 ， 给 了 我 很 大 
的 帮助 。 有 君 相 佐 力 此 生 之 幸 。 


















































有 幸 降 生 在 这 个 物理 世界 ， 委 实 是 一 件 值得 感谢 的 习 
余生 也 望 多 多 指教 。 


HH 
0o 


315 


版 权 声 明 


The Principles of Programming 

Copyright © Isao Ueda. 2016 

All rights reserved. 

First original Japanese edition published by SHUWA SYSTEM CO., LTD., Japan. 
Chinese (in simplified character only) translation rights arranged with 

SHUWA SYSTEM CO., LTD., Japan. 

through CREEK & RIVER CO., LTD. and CREEK & RIVER SHANGHAI CO., LID. 





本 书 中 文 简体 字 版 由 SHUWA SYSTEM CO., LTD., Japan 授权 人 民 邮 
电 出 版 社 独家 出 版 。 未 经 出 版 者 书面 许可 ， 不 得 以 任何 方式 复制 或 抄袭 
本 书 内 容 。 

版 权 所 有 ， 侵 权 必 究 。 














ee 


回复 “ 修炼 ”查看 相关 书 单 


© 
微 博 连接 
关注 @ 图 灵 教育 每 日 分 享 上 IT 好 书 


i 


QQ 连接 


图 灵 读 者 官方 群 I[: 218139230 
图 灵 读 者 官方 群 [[: 164939616 


图 灵 社 区 
iTuring.cn 
在 线 出 版 , 电子 书 ,《 码 农 》 杂 志 , 图 灵 访谈 





> 代码 发 布 后 频频 发 生 故 障 

> 隔 段 时 间 再 看 自己 写 的 代码 ， 会 为 其 可 读 性 之 差 而 感到 震惊 
> 修改 代码 后 ， 程 序 完 全 不 能 运行 了 

> 想 在 代码 中 添加 功能 ， 却 不 知 改 哪里 


























这 些 困 扰 ， 就 请 读 一 读 这 本 书 。 








| 经 典 实用 | 
101 个 编程 原则 ， 既 有 对 经 典 书籍 内 容 精华 的 总 结 ， 又 有 作者 自身 的 





经 验 之 谈 ， 是 指导 程序 员 进一步 提升 编程 能 力 的 行动 指南 。 


编排 创新 | 


各 原则 独立 成 文 ， 从 “这 个 原则 是 什么 ” “为 什么 要 遵循 这 个 原 
则 ”“ 具 体 应 该 怎么 做 ”3 个 角度 进行 解读 ， 简 洁 明 了 ， 即 使 是 编程 
新 手 ， 也 能 轻松 看 懂 。 


扩展 提高 | 


同时 介绍 各 原则 相关 的 延伸 信息 和 出 处 、 参 考 文献 ， 为 读者 进一步 
阅读 提供 信息 来 源 。 














网 











ISBN 978-7-115-53914-4 
灵 社 区 : iTuring.cn 川 539144l> 


分 类 建议 : 计算 机 /软件 开发 Ea A 一 
:59.00 
人 民 邮 电 出 版 社 网 址 : www.ptpress.com.cn 定价 a 


